Claude Code Skills

The Canon plugin for Claude Code provides slash commands (skills) for spec-driven development.

Installation

Add the Canon marketplace and install the plugin:

claude plugin marketplace add canonhq/canon
claude plugin install canon

Skills are then available as /canon:<skill> (e.g., /canon:verify).

Skills

/canon:context — Load Spec Context

Load spec context for your current task. Automatically identifies relevant specs from git changes or a user-provided topic.

Usage:

/canon:context
/canon:context auth migration

What it does:

• Scans git diff to find changed files
• Matches changes against spec sections
• Loads relevant specs, ACs, and ticket links into context

/canon:task — Work on a Task

Pick up a spec-driven task, work through its acceptance criteria, and mark it done.

Usage:

/canon:task

What it does:

• Lists available tasks from spec acceptance criteria
• Guides you through implementation of each AC
• Marks ACs as realized with code evidence
• Updates spec status when all ACs are done

/canon:verify — Verify Implementation

Verify code against spec acceptance criteria. Use after implementing a feature or during code review.

Usage:

/canon:verify
/canon:verify docs/specs/auth-hardening.md

What it does:

• Evaluates each AC as realized, partial, or conflicting
• Reports evidence (file, line numbers) for each evaluation
• Suggests spec or code updates for conflicts

/canon:new — Create a Spec

Create a new spec document from a template.

Usage:

/canon:new
/canon:new "User Notifications"

What it does:

• Walks through structured creation with prompts for title, team, tags
• Creates spec file from template
• Optionally commits to git

/canon:review — Review Against Docs

Review code changes against all documentation — specs, ADRs, READMEs, architecture docs.

Usage:

/canon:review

What it does:

• Scans all indexed docs for conflicts with current changes
• Flags stale documentation
• Suggests doc updates

/canon:status — Coverage Dashboard

Show spec coverage dashboard.

Usage:

/canon:status

What it does:

• Displays per-spec and per-section coverage metrics
• Shows realized vs. total acceptance criteria
• Highlights stale or blocked sections

/canon:plan — Spec-Driven Planning

Start a spec-driven planning workflow from exploration through spec creation to implementation tasks.

Usage:

/canon:plan

What it does:

• Explores codebase to understand current state
• Proposes spec structure
• Creates spec with sections and ACs
• Generates implementation tasks

/canon:update — Update Spec Statuses

Update spec statuses based on code implementation evidence.

Usage:

/canon:update
/canon:update docs/specs/auth-hardening.md

What it does:

• Scans codebase for implementation evidence
• Proposes status transitions for spec sections
• Applies updates with realization evidence

/canon:audit — Full Spec Audit

Full audit workflow: scan all specs against the codebase, update statuses, sync to ticket system, and commit. Combines /canon:update + canon sync into a single command.

Usage:

/canon:audit

What it does:

• Discovers all specs and audits each against the codebase in parallel
• Updates section statuses based on implementation evidence
• Runs canon sync to create/update GitHub Issues for actionable sections
• Commits and pushes the changes