By srotbart
Spec-driven development: declare what must be true, let agents find and close the gaps.
Use when the user invokes `/sdd:explain <subject>`, asks to "explain how X works", "document X", "write an explanation of X", or wants a deep-dive document on a component, concept, or subsystem in the current project. Spawns a dedicated sdd-explainer agent that writes to `.sdd/projections/<subject>.md` and can work interactively (asking what to explore next) or autonomously (full document without prompts).
This skill should be used when the user invokes `/sdd:gap-to-work-items`, says "decompose gaps into work items", "create work items for GAP-auth", "generate work items from gap report", "break down gaps for authentication", or wants to turn open gap files into actionable work items. Takes a domain or specific gap ID as input and produces scoped work-item files.
This skill should be used when the user invokes `/sdd:install-statusline` or asks to "install the SDD statusline", "set up the statusline", or "add SDD statusline to Claude Code". Appends a minimal SDD delegation block to the user's global statusline script so that an SDD line appears when inside a repo with a .sdd/ directory.
This skill should be used when the user invokes `/sdd:next`, says "what should I do next", "what's the next step", "recommend a next action", "prioritise SDD work", or wants a ranked list of candidate next actions across all domains with priority, recommendation, and size signals, and then routes the chosen action to the appropriate skill.
Use when the user invokes `/sdd:projection-comments <name>`, says "address projection comments for <name>", "process comments on <name>", or wants to apply and prune pending comments on a projection document. Reads the co-located .comments.json, applies clarify/re-evaluate/expand/condense edits to the projection markdown, removes addressed entries, and leaves unaddressable entries in place.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Shift the workflow from telling agents what to do toward declaring what must be true. Agents find the gaps and close them.
Instead of telling the agent what to do, declare what must be true. The agent finds where reality diverges from the declaration and closes the gaps. This produces:
Write a target → negotiate it → fold into spec → audit codebase → decompose gaps → close work items
Terminal state: no open gaps, no pending work items.
All state lives under .sdd/ at the project root:
| Directory | Purpose | Who writes it |
|---|---|---|
.sdd/targets/ | User-written intent. Negotiated in-document. | User (agent responds) |
.sdd/specs/ | Canonical, structured specifications. The source of truth. | Agent (from targets) |
.sdd/gaps/ | Audit reports — where the codebase diverges from the spec. | Agent (from audit) |
.sdd/work-items/ | Scoped tasks that close gaps. | Agent (from gaps) |
Specs are durable — they never archive. Everything else has an archive/
subdirectory; terminal-state artifacts move there immediately, preserving provenance
via frontmatter references back to the spec.
| Skill | Invoke | Purpose |
|---|---|---|
| Explain | /sdd:explain | Use when the user invokes /sdd:explain <subject>, asks to "explain how X works", "document X", "write an explanation of X", or wants a deep-dive document on a component, concept, or subsystem in the current project |
| Gap To Work Items | /sdd:gap-to-work-items | says "decompose gaps into work items", "create work items for GAP-auth", "generate work items from gap report", "break down gaps for authentication", or wants to turn open gap files into actionable work items |
| Install Statusline | /sdd:install-statusline | invokes /sdd:install-statusline or asks to "install the SDD statusline", "set up the statusline", or "add SDD statusline to Claude Code" |
| Next | /sdd:next | says "what should I do next", "what's the next step", "recommend a next action", "prioritise SDD work", or wants a ranked list of candidate next actions across all domains with priority, recommendation, and size signals, and then routes the chosen action to the appropriate skill |
| Review Engage | /sdd:review-engage | says "engage issue ISS-auth-001", "engage improvement IMP-auth-001", "discuss this finding", "accept this issue", "dismiss this improvement", "what should I do about ISS-X", or wants to interactively decide what to do with an issue or improvement artifact |
| Review Improvements | /sdd:review-improvements | says "find improvements", "suggest refactors", "what can be simplified", "propose enhancements", or wants a 3-agent team to propose improvements — enhancements, refactors, simplifications, performance, ergonomics, better patterns |
| Review Issues | /sdd:review-issues | says "run a code review", "find issues in the codebase", "sweep for problems", "review domain X for issues", or wants a 3-agent team to flag code bugs, anti-patterns, smells, and spec problems and write them as issue artifacts |
| Sdd Help | /sdd:sdd-help | says "how does SDD work", "explain spec-driven development", "what is the SDD workflow", "how do I use SDD", "explain the SDD pipeline", "what are SDD skills", or wants to understand spec-driven development before starting or when confused about the workflow |
| Sdd Init | /sdd:sdd-init | says "initialize SDD", "set up SDD", "create the SDD folder", "bootstrap SDD for this project", or wants to start using spec-driven development in a project that has no .sdd/ directory yet |
| Session Start | /sdd:session-start | says "start my SDD session", "show SDD state", "what's pending in SDD", "what targets are waiting", "check my SDD", or begins work on a spec-driven project and wants a status snapshot |
| Spawn Sdd Worker | /sdd:spawn-sdd-worker | Use when the user invokes /sdd:spawn-sdd-worker, says "spawn the sdd worker", "start the sdd worker", "hand off execution to the worker", or wants to delegate the execution phase (spec-audit, gap creation, work item closure) to an autonomous agent for a given domain |
| Spec Audit | /sdd:spec-audit | says "audit the spec", "audit authentication spec", "check the codebase against spec", "find gaps in SPEC-auth", "run a gap audit", "audit SPEC-auth-003", or wants to know where the codebase diverges from a spec |
| Spec Collapse | /sdd:spec-collapse | says "collapse the spec", "consolidate spec items", "merge spec items", "clean up the spec", "spec is getting messy", or wants to propose structural reorganisation of spec files |
npx claudepluginhub srotbart/sdd --plugin sddDesign fluency for frontend development. 1 skill with 23 commands (/impeccable polish, /impeccable audit, /impeccable critique, etc.) and curated anti-pattern detection.
Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations on LLM coding pitfalls
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.
Develop, test, build, and deploy Godot 4.x games with Claude Code. Includes GdUnit4 testing, web/desktop exports, CI/CD pipelines, and deployment to Vercel/GitHub Pages/itch.io.
Complete developer toolkit for Claude Code