Documentation

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

AgentSkill directoryInvocation
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.

SkillPurpose
cumaru-searchFind knowledge when the owning file is unknown: context, tree, or exact search.
cumaru-doctorRun doctor, navigate to reported locations, and propose only safe fixes.
cumaru-updateUpdate the framework, reconcile framework-owned files, and repair agent artifacts.
cumaru-roleLoad one declared role after reloading the bootstrap context.
cumaru-disciplineApply one named discipline to one selected file.
cumaru-flowRun one named workflow from config.yaml as a dependency graph.
cumaru-refsClose spec-to-code coverage gaps by writing reference rows.
cumaru-summarizeRepair or refresh .cumaru summary: frontmatter, only on explicit request.
cumaru-installAdopt 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.

SkillPurposeDomains
cumaru-absorbClose 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-planAuthor plans, tasks, handoffs, and the delta draft.sdlc-light (recipe),sdlc-full (recipe),design-as-code (recipe),iac-basic (recipe),qa-basic (recipe)
cumaru-exploreCapture, evolve, promote, or drop a pre-plan idea.sdlc-light (recipe),sdlc-full (recipe),iac-basic (recipe),qa-basic (recipe)
cumaru-intakeMirror a tracker item into the intake pillar.sdlc-full (recipe),design-as-code (recipe),iac-basic (recipe),qa-basic (recipe)
cumaru-issueCapture and promote a locally authored issue.sdlc-full (recipe)
cumaru-specsBootstrap, deepen, or consolidate specs.sdlc-light (recipe),sdlc-full (recipe),design-as-code (recipe)
cumaru-conceptCreate, compare, select, or reject design concepts.design-as-code (recipe)
cumaru-topologyGrow or maintain the topology pillar.iac-basic (recipe)
cumaru-archRender the infrastructure topology as a text diagram.iac-basic (recipe)
cumaru-coverageGrow or maintain the coverage pillar.qa-basic (recipe)
cumaru-captureCapture raw material into the inbox.vault-memory (recipe)
cumaru-draftWrite or organize rough notes.vault-memory (recipe)
cumaru-distillTurn captures and drafts into memory nodes.vault-memory (recipe)
cumaru-linkAdd typed relationships between memories.vault-memory (recipe)
cumaru-directivesGenerate or refine priority directives.focus (recipe)
cumaru-sourcesScan active sources and update threads.focus (recipe)
cumaru-threadCapture or update one thread.focus (recipe)
cumaru-outcomeDerive or move an outcome from threads.focus (recipe)
cumaru-zoomDiscuss 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
SkillScope
gitAllows mutating Git commands under explicit policies: no unrequested commits, no force push to main.
terraformTerraform or OpenTofu work; companion to iac-basic.
pulumiPulumi programs, previews, and stacks; companion to iac-basic.
pytestpytest suites, fixtures, and coverage; companion to qa-basic.
vitestVitest or Jest suites; companion to qa-basic.
cypressCypress e2e and component tests; companion to qa-basic.
playwrightPlaywright browser tests; companion to qa-basic.
skill-to-disciplineDistill an external skill into a local, attributed discipline.

Sources: Available skills, Agent adapters, each linked SKILL.md at revision 37ad79f.