Skip to content
Back to search

sdd-skill

A comprehensive Claude Code skill for guiding users through GitHub's Spec-Kit and the Spec-Driven Development methodology.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spillwavesolutions--sdd-skill/badge.svg)](/listings/spillwavesolutions--sdd-skill)

HTML

<a href="/listings/spillwavesolutions--sdd-skill"><img src="/api/listings/spillwavesolutions--sdd-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- Persistent installation (recommended) using `uv tool install` - One-time usage with `uvx` - Installation verification with `specify check` - Troubleshooting for common issues

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 186 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Spec-Driven Development (SDD) Skill
  2. A comprehensive Claude Code skill for guiding users through GitHub's Spec-Kit and the Spec-Driven Development methodology.
  3. ## What is Spec-Driven Development?
  4. Spec-Driven Development flips traditional software development on its head. Instead of treating specifications as temporary scaffolding, SDD makes them **executable** - they directly generate working implementations rather than just guiding them.
  5. ## What's New in v2.1.0
  6. ### 🎯 Enhanced Explanations & Summaries
  7. - **10-Point Summary Template**: Structured summaries after every SDD command showing key decisions, what was generated, items to review, watch-outs, and next steps
  8. - **Rationale for Decisions**: Every major decision includes "why" it was made
  9. - **No More Black Boxes**: Clear explanations eliminate the mystery of what was just generated
  10. ### 📊 Feature Status Tracking
  11. - **Automatic Progress Tracking**: See exactly where each feature is (Specified, Planned, Tasked, In Progress, Complete)
  12. - **Hybrid Status Display**: Brief status line in every summary + detailed dashboard on demand
  13. - **Dependency Visualization**: See what features depend on what, and what's blocking progress
  14. - **Progress Percentages**: Automatic calculation based on workflow completion (20%, 40%, 60%, 80%, 100%)
  15. ### 💬 Natural Language Feature Management
  16. - **Add Features**: Just say "Add a feature for email notifications"
  17. - **Reorder Features**: "Move user-notifications before profile-management"
  18. - **Remove Features**: "We don't need reporting anymore"
  19. - **Show Status**: "Show me all features" or "What's blocking admin-dashboard?"
  20. - **Check Dependencies**: "Can we start profile-management yet?"
  21. ### 📁 Brownfield Support
  22. Comprehensive support for **existing codebases**! Reverse-engineer existing projects into SDD format, generate constitutions from existing code, and integrate new features into legacy systems.
  23. ## Quick Start
  24. To use this skill, simply mention any of these trigger words in your conversation with Claude:
  25. **General SDD:**
  26. - "spec-driven development", "sdd", "speckit"
  27. - "specify cli", "/speckit"
  28. - "executable specifications"
  29. **For New Projects (Greenfield):**
  30. - "new project", "from scratch"
  31. - "specify init"
  32. **For Existing Projects (Brownfield):**
  33. - "brownfield", "existing codebase"
  34. - "legacy code", "modernization"
  35. - "reverse engineer", "codebase analysis"
  36. **For Feature Management:**
  37. - "feature status", "track features"
  38. - "add feature", "move feature"
  39. - "show features", "feature progress"
  40. ## What This Skill Provides
  41. ### 1. Installation Guidance
  42. - Persistent installation (recommended) using `uv tool install`
  43. - One-time usage with `uvx`
  44. - Installation verification with `specify check`
  45. - Troubleshooting for common issues
  46. ### 2. Complete Workflow Support
  47. **Greenfield Workflow** (New Projects - 6 steps):
  48. 1. **Initialize Project**: `specify init`
  49. 2. **Establish Principles**: `/speckit.constitution`
  50. 3. **Create Specification**: `/speckit.specify`
  51. 4. **Technical Planning**: `/speckit.plan`
  52. 5. **Task Breakdown**: `/speckit.tasks`
  53. 6. **Implementation**: `/speckit.implement`
  54. **Brownfield Workflow** (Existing Projects - 7 steps):
  55. 1. **Analyze Codebase**: `/speckit.brownfield`
  56. 2. **Initialize SDD**: `specify init --here --force`
  57. 3. **Generate Constitution**: `/speckit.analyze-codebase`
  58. 4. **Choose Strategy**: `/speckit.reverse-engineer`
  59. 5. **Document Features**: (optional, based on strategy)
  60. 6. **Specify New Feature**: `/speckit.specify`
  61. 7. **Integration Planning**: `/speckit.integration-plan`
  62. ### 3. Feature Status Tracking & Management
  63. - **Automatic Progress Tracking**: Tracks each feature through Specified (20%) → Planned (40%) → Tasked (60%) → In Progress (80%) → Complete (100%)
  64. - **Natural Language Commands**: "Add feature for X", "Move feature Y before Z", "Show feature status"
  65. - **Dependency Management**: Automatic dependency tracking and blocking detection
  66. - **Status Dashboard**: Brief status in every summary + detailed dashboard on demand (`/speckit.status` or option [D])
  67. ### 4. Optional Enhancement Commands
  68. - `/speckit.clarify` - Clarify underspecified areas
  69. - `/speckit.analyze` - Consistency & coverage analysis
  70. - `/speckit.checklist` - Generate quality validation checklists
  71. ### 5. Validation Commands (Brownfield)
  72. - `/speckit.validate-reverse-engineering` - Verify reverse-engineering accuracy
  73. - `/speckit.coverage-check` - Check documentation coverage
  74. - `/speckit.validate-constitution` - Validate constitution consistency
  75. - `/speckit.trace [feature]` - Spec-to-code traceability
  76. ### 5. Development Phase Support
  77. - **Greenfield (0-to-1)**: Build new projects from scratch
  78. - **Brownfield (Existing)**: Reverse-engineer and enhance existing codebases
  79. - **Creative Exploration**: Try multiple tech stacks in parallel
  80. - **Legacy Modernization**: Systematically upgrade old systems
  81. ### 6. Best Practices
  82. - For new users: Start small, follow the sequence
  83. - For experienced users: Parallel exploration, custom checklists
  84. - For enterprise teams: Establish constitution early, version control everything
  85. ## Artifacts Generated
  86. After running SDD commands, expect these artifacts:
  87. ```
  88. project-name/
  89. ├── .speckit/
  90. │ ├── constitution.md # Project principles
  91. │ ├── features/
  92. │ │ └── 001-feature-name/
  93. │ │ ├── specify.md # Requirements
  94. │ │ ├── plan.md # Technical plan
  95. │ │ ├── tasks.md # Task breakdown
  96. │ │ └── checklist.md # Quality gates
  97. │ └── .claude/
  98. │ └── commands/ # Slash commands
  99. └── [application code]
  100. ```
  101. ## Supported AI Agents
  102. Works with Claude Code, GitHub Copilot, Cursor, Windsurf, Gemini CLI, and many others (see skill.md for full list).
  103. ## Prerequisites
  104. Users need:
  105. - `uv` for package management
  106. - Python 3.11+
  107. - Git
  108. - A supported AI coding agent
  109. ## Example Usage
  110. ```bash
  111. # Install specify-cli
  112. uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
  113. # Initialize project
  114. specify init my-app --ai claude
  115. # Then in the AI agent:
  116. /speckit.constitution Create principles for production-ready web apps...
  117. /speckit.specify Build a task management app with drag-and-drop...
  118. /speckit.plan Use React with TypeScript, Vite, and Tailwind CSS...
  119. /speckit.tasks
  120. /speckit.implement
  121. ```
  122. ## Files in This Skill
  123. - **SKILL.md**: Modern skill with YAML frontmatter and lean orchestration (v2.1.0)
  124. - **README.md**: This file - quick reference
  125. - **CLAUDE.md**: Repository guidance for AI agents
  126. - **references/**: Detailed workflow documentation
  127. - **sdd_install.md**: Installation and setup guide
  128. - **greenfield.md**: Complete greenfield workflow with enhanced summaries (6 steps)
  129. - **brownfield.md**: Complete brownfield workflow with enhanced summaries (7 steps)
  130. - **feature_management.md**: Comprehensive feature management guide (NEW in v2.1.0)
  131. ## Resources
  132. - GitHub Spec-Kit: https://github.com/github/spec-kit
  133. - Issues/Support: https://github.com/github/spec-kit/issues
  134. ## Philosophy
  135. Remember: This is **AI-native development**. Specifications aren't just documentation - they're executable artifacts that directly drive implementation. The AI agent uses them to generate working code that matches the intent defined in the specs.
  136. ---
  137. **Maintained by**: Based on GitHub Spec-Kit by Den Delimarsky (@localden) and John Lam (@jflam)
  138. **License**: MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.