Reference
Skills
A skill is a guided workflow your agent runs. It is not a CLI command, and it never grants a role more authority. Install places the domain's skills in the agent's skill directory.
Invoke a skill
| Agent | Skill directory | Invocation |
|---|---|---|
| Codex | .agents/skills/ | $cumaru-discipline or a natural request |
| Claude | .claude/skills/ | /cumaru-discipline or a natural request |
| OpenCode | .agents/skills/ | /cumaru/discipline launcher |
| Generic (none) | .agents/skills/ | /cumaru:discipline launcher |
A launcher is a thin command file that forwards to the namesake skill; the skill holds the workflow.
Universal skills
Every domain ships these. Copies are not always identical: each domain owns its cumaru-install, and the focus domain ships its own cumaru-doctor variant. The
links below open the base copy; check your domain's skill directory for the installed one.
| Skill | Purpose |
|---|---|
cumaru-search | Find knowledge when the owning file is unknown: context, tree, or exact search. |
cumaru-doctor | Run doctor, navigate to reported locations, and propose only safe fixes. |
cumaru-update | Update the framework, reconcile framework-owned files, and repair agent artifacts. |
cumaru-role | Load one declared role after reloading the bootstrap context. |
cumaru-discipline | Apply one named discipline to one selected file. |
cumaru-flow | Run one named workflow from config.yaml as a dependency graph. |
cumaru-refs | Close spec-to-code coverage gaps by writing reference rows. |
cumaru-summarize | Repair or refresh .cumaru summary: frontmatter, only on explicit request. |
cumaru-install | Adopt the domain and bootstrap its durable pillar. Each domain ships its own variant. Variants: base,sdlc-light,sdlc-full,design-as-code,iac-basic,qa-basic,vault-memory,focus,homebrew-management,ai-ccn. |
Domain skills
These ship only with the listed domains. A same-named skill can have different authority per domain; the link opens one variant, and each domain profile names its own.
| Skill | Purpose | Domains |
|---|---|---|
cumaru-absorb | Close a verified plan: write its delta into the durable pillar and clean transient work. | sdlc-light (recipe),sdlc-full (recipe),design-as-code (recipe),iac-basic (recipe),qa-basic (recipe) |
cumaru-plan | Author plans, tasks, handoffs, and the delta draft. | sdlc-light (recipe),sdlc-full (recipe),design-as-code (recipe),iac-basic (recipe),qa-basic (recipe) |
cumaru-explore | Capture, evolve, promote, or drop a pre-plan idea. | sdlc-light (recipe),sdlc-full (recipe),iac-basic (recipe),qa-basic (recipe) |
cumaru-intake | Mirror a tracker item into the intake pillar. | sdlc-full (recipe),design-as-code (recipe),iac-basic (recipe),qa-basic (recipe) |
cumaru-issue | Capture and promote a locally authored issue. | sdlc-full (recipe) |
cumaru-specs | Bootstrap, deepen, or consolidate specs. | sdlc-light (recipe),sdlc-full (recipe),design-as-code (recipe) |
cumaru-concept | Create, compare, select, or reject design concepts. | design-as-code (recipe) |
cumaru-topology | Grow or maintain the topology pillar. | iac-basic (recipe) |
cumaru-arch | Render the infrastructure topology as a text diagram. | iac-basic (recipe) |
cumaru-coverage | Grow or maintain the coverage pillar. | qa-basic (recipe) |
cumaru-capture | Capture raw material into the inbox. | vault-memory (recipe) |
cumaru-draft | Write or organize rough notes. | vault-memory (recipe) |
cumaru-distill | Turn captures and drafts into memory nodes. | vault-memory (recipe) |
cumaru-link | Add typed relationships between memories. | vault-memory (recipe) |
cumaru-directives | Generate or refine priority directives. | focus (recipe) |
cumaru-sources | Scan active sources and update threads. | focus (recipe) |
cumaru-thread | Capture or update one thread. | focus (recipe) |
cumaru-outcome | Derive or move an outcome from threads. | focus (recipe) |
cumaru-zoom | Discuss one existing thread in the conversation. | focus (recipe) |
Opt-in skills
These never install automatically. Add one explicitly after adoption, then apply:
cumaru update skills <agent> --with <skill> --apply | Skill | Scope |
|---|---|
git | Allows mutating Git commands under explicit policies: no unrequested commits, no force push to main. |
terraform | Terraform or OpenTofu work; companion to iac-basic. |
pulumi | Pulumi programs, previews, and stacks; companion to iac-basic. |
pytest | pytest suites, fixtures, and coverage; companion to qa-basic. |
vitest | Vitest or Jest suites; companion to qa-basic. |
cypress | Cypress e2e and component tests; companion to qa-basic. |
playwright | Playwright browser tests; companion to qa-basic. |
skill-to-discipline | Distill an external skill into a local, attributed discipline. |
Sources: Available skills, Agent adapters, each linked SKILL.md at revision 37ad79f.