from the-startup284
Create structured product or feature specifications from a short prompt; manages PRD/SDD/PLAN phases, directory scaffolding, and decision tracking.
Specify turns a brief description into a full specification workflow. It guides the agent through initialization, research, and a three-phase write process (PRD → SDD → PLAN), scaffolding directories and README tracking, and ensuring decisions are recorded. The skill delegates research to specialised sub-agents, suggests the appropriate mode (Standard vs Agent Team), and strictly enforces phase-by-phase progression and user confirmations.
Use Specify when you need a repeatable, auditable specification process for a new feature, product, or integration. Ideal for projects that need clear separation between business requirements (PRD), technical design (SDD), and implementation planning (PLAN), or when multiple perspectives must be synthesized by specialist agents.
Optimised for agent runtimes that support spawning sub-agents and file IO (e.g., Claude Code, agentic runtimes that support sessions_spawn). The workflow assumes the agent can run shell/git commands and manage local .start/docs directories.
Specify is a specification-creation skill that orchestrates a multi-phase workflow (Requirements → Solution → Factory) using subagent delegation and decision tracking. No bundled scripts — pure prompt-based orchestration with references to companion skills (specify-meta, specify-requirements, etc.). Well-structured with clear phases, user checkpoints, and mode selection. Security is clean: no network calls, no destructive commands, only writes to .start/ and docs/ directories.
Clean skill with no scripts. Well-designed multi-phase spec workflow with good separation of concerns. References external skills for delegation rather than doing everything inline. Constraints are sensible (only write to .start/ and docs/, wait for user confirmation between phases). Agent Team mode with persistent researchers is a thoughtful feature for complex domains. Usefulness tempered by dependency on companion skills in the same ecosystem.
