Skills Reference

Skills are shortcuts. Type /skill-name in Claude Code.

Quick Reference

Skill	What it Does
/brainstorm	Socratic brainstorming before planning
/plan	Plan a feature
/tdd	Test-driven development
/debug	Debug an issue
/checkpoint	Save/restore progress
/estimate	Estimate token cost
/finish	Finalize branch
/health	Project health score
/remember	Save a decision
/recall	Recall decisions
/learn	Learn while building
/tutorial	Interactive tutorial
/migrate-framework	Migrate between frameworks
/verify	Verification before completion (proof-based)
/write-skill	Create or improve skills with TDD
/codereview	Multi-reviewer parallel code review
/commit	Smart conventional commits
/lint	Lint and auto-fix
/audit	Multi-domain code audit
/onboard	Codebase onboarding for new developers
/worktree	Git worktree isolation for parallel tasks

---

Workflow Skills

/brainstorm

Socratic brainstorming before planning.

/brainstorm add real-time notifications

Refines ideas through 5 phases: Discovery, Clarification, Assumption Testing, Alternative Generation, and Convergence. Presents design in digestible sections for user approval.

Output: Design document with tested assumptions, 3+ alternatives compared, and approved direction ready for /plan.

---

/plan

Plan a feature adaptively.

/plan add user authentication

Output: Task list with complexity assessment.

---

/tdd

Test-Driven Development workflow.

/tdd implement calculateDiscount

Process:

1. RED — Write failing test
2. GREEN — Make it pass
3. REFACTOR — Improve code

No code without failing test first.

---

/debug

4-phase systematic debugging.

/debug the login shows 500 error

Phases: Gather → Analyze → Test → Fix

---

/checkpoint

Git checkpoint management.

/checkpoint create before-refactor
/checkpoint list
/checkpoint restore before-refactor

Never lose work.

---

/estimate

Estimate token cost before starting.

/estimate add payment integration

Know the cost upfront.

---

/finish

Finalize branch with metrics.

/finish feature/auth

Output: Token usage, files changed, tests status.

---

/learn

Learning mode — explains while building.

/learn create a products module

Great for onboarding.

---

/verify

Verification before claiming work is complete.

/verify

Forces proof-based verification — requires command output, not just "it works." Use after completing any task to ensure correctness with evidence.

Output: Verification report with proof artifacts (test results, build output, runtime checks).

---

/write-skill

Create or improve skills using TDD methodology.

/write-skill my-new-skill

Process:

1. RED — Define what the skill should do (failing spec)
2. GREEN — Write the skill to meet the spec
3. REFACTOR — Improve clarity and structure

RED-GREEN-REFACTOR applied to documentation and skill design.

---

Project Skills

/health

Project health score (0-100).

/health
/health quick
/health detailed

Checks: Architecture, tests, types, security, performance.

---

/remember

Save a decision to session memory.

/remember use Zustand for state management

Persists across sessions.

---

/recall

Query session memory.

/recall state management
/recall all

---

/tutorial

Interactive tutorial.

/tutorial beginner
/tutorial intermediate
/tutorial advanced

---

/onboard

Codebase onboarding for new developers.

/onboard

Maps architecture, detects conventions, and analyzes key modules. Generates a developer guide with getting-started instructions.

Output: Developer onboarding guide with architecture map, conventions, and setup instructions.

---

/worktree

Git worktree isolation for parallel tasks.

/worktree auth-refactor

Creates isolated workspaces so you can work on multiple features simultaneously. No branch switching, no stashing, no conflicts.

Commands:

• /worktree [name] — Create isolated workspace
• git worktree list — List active worktrees
• git worktree remove [path] — Remove worktree

Output: Worktree created with dependencies installed and baseline tests passing.

---

Migration Skills

/migrate-framework

Migrate between frameworks.

/migrate-framework react to vue src/components/Button.tsx

Supports:

• React → Vue
• React → Svelte
• Vue → React
• Vue → Svelte
• Vue 2 → Vue 3

---

/codereview

Multi-reviewer parallel code review.

/codereview src/modules/auth
/codereview src/modules/orders

Dispatches 3 concurrent review perspectives: architecture (@reviewer), security (@security), and tests (@tester). Consolidates findings with severity ratings and produces a unified verdict.

Output: APPROVE / REQUEST_CHANGES / BLOCK with evidence from all 3 perspectives.

---

/commit

Smart conventional commits.

/commit
/commit "add JWT refresh rotation"

Auto-detects type and scope from changed files. Validates for secrets, debug artifacts, and large files before committing. Follows conventional commits format.

Output: type(scope): description commit with validation report.

---

/lint

Lint and auto-fix.

/lint
/lint src/modules/auth

Auto-detects linter (Biome, ESLint, Deno) and formatter (Prettier). Runs auto-fix first, then reports remaining issues that need manual intervention.

Output: Fixed count, remaining issues with file:line references.

---

Development Skills

/dev-create-module

Full module scaffold.

/dev-create-module orders

Creates: types, service, adapter, components, tests.

---

/dev-create-component

Create a component.

/dev-create-component OrderCard

---

/dev-create-service

Create service layer.

/dev-create-service orders

Creates: types, contracts, adapter, service.

---

/dev-create-hook

Create a hook (React/Next.js).

/dev-create-hook useOrders

---

/dev-create-composable

Create a composable (Vue).

/dev-create-composable useOrdersList

---

/dev-create-test

Create tests for a file.

/dev-create-test src/modules/orders/adapters/order-adapter.ts

---

/dev-generate-types

Generate types from endpoint or JSON.

/dev-generate-types /v2/orders

---

Review Skills

/review-review

Code review with verdict.

/review-review src/modules/orders/

Checks: Spec compliance, code quality, architecture.

---

/review-check-architecture

Architecture conformance checks.

/review-check-architecture orders

14 automated checks.

---

/review-fix-violations

Auto-fix violations.

/review-fix-violations orders

---

/audit

Multi-domain code audit in one pass.

/audit src/modules/auth

Covers: Security (OWASP), performance, architecture, dependencies. Outputs severity-rated findings with remediation steps.

Output: Audit report with categorized findings, severity levels, and actionable remediation.

---

Documentation Skills

/docs-onboard

Quick module summary.

/docs-onboard orders

Understand any module in 2 minutes.