Initialize and manage specification directories with auto-incrementing IDs. Use when creating new specs, checking spec status, tracking user decisions, or managing the docs/specs/ directory structure. Maintains README.md in each spec to record decisions (e.g., PRD skipped), context, and progress. Orchestrates the specification workflow across PRD, SDD, and PLAN phases.
View on GitHubplugins/start/skills/specification-management/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/rsmdt/the-startup/blob/main/plugins/start/skills/specification-management/SKILL.md -a claude-code --skill specification-managementInstallation paths:
.claude/skills/specification-management/# Specification Management Skill You are a specification workflow orchestrator that manages specification directories and tracks user decisions throughout the PRD → SDD → PLAN workflow. ## When to Activate Activate this skill when you need to: - **Create a new specification** directory with auto-incrementing ID - **Check specification status** (what documents exist) - **Track user decisions** (e.g., "PRD skipped because requirements in JIRA") - **Manage phase transitions** (PRD → SDD → PLAN) - **Initialize or update README.md** in spec directories - **Read existing spec metadata** via spec.py ## Core Responsibilities ### 1. Directory Management Use `spec.py` to create and read specification directories: ```bash # Create new spec (auto-incrementing ID) ~/.claude/plugins/marketplaces/the-startup/plugins/start/skills/specification-management/spec.py "feature-name" # Read existing spec metadata (TOML output) ~/.claude/plugins/marketplaces/the-startup/plugins/start/skills/specification-management/spec.py 004 --read # Add template to existing spec ~/.claude/plugins/marketplaces/the-startup/plugins/start/skills/specification-management/spec.py 004 --add product-requirements ``` **TOML Output Format:** ```toml id = "004" name = "feature-name" dir = "docs/specs/004-feature-name" [spec] prd = "docs/specs/004-feature-name/product-requirements.md" sdd = "docs/specs/004-feature-name/solution-design.md" files = [ "product-requirements.md", "solution-design.md" ] ``` ### 2. README.md Management Every spec directory should have a `README.md` tracking decisions and progress. **Create README.md** when a new spec is created: ```markdown # Specification: [NNN]-[name] ## Status | Field | Value | |-------|-------| | **Created** | [date] | | **Current Phase** | Initialization | | **Last Updated** | [date] | ## Documents | Document | Status | Notes | |----------|--------|-------| | product-requirements.md | pending | | | solution-design.md | pending | | | implementa