ReddRadar
Agent skill
specification-writing
Write feature specifications as requirements and user stories with acceptance criteria, focusing on business value and testable conditions.
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/methodologies/spec-kit/skills/specification-writing
SKILL.md
Specification Writing
Overview
Write comprehensive feature specifications from business-level descriptions. Produces requirements, user stories, acceptance criteria, and scope boundaries that define WHAT to build without prescribing HOW.
When to Use
- Defining a new feature before planning or implementation
- Formalizing vague feature requests into structured requirements
- Clarifying scope boundaries for a feature area
- Establishing acceptance criteria for user stories
Key Principle
Specifications describe desired behavior from the user's perspective. They define what the system should do, not how it should be built. Business value must be explicit in every requirement.
Process
- Elicit requirements - Extract functional and non-functional requirements from feature description
- Write user stories - Author stories in standard format with personas
- Define acceptance criteria - Testable conditions for each story (Given/When/Then)
- Identify edge cases - Error scenarios and boundary conditions
- Clarify gaps - Surface and resolve ambiguities and contradictions
- Document assumptions - Make implicit assumptions explicit
- Define scope - Clearly delineate in-scope vs. out-of-scope
- Human review - Approve specification before planning
Tool Use
Invoke via babysitter process: methodologies/spec-kit/spec-kit-specification
Full pipeline: methodologies/spec-kit/spec-kit-orchestrator
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
a5c-ai/babysitter
gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
a5c-ai/babysitter
model-profile-resolution
Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.
a5c-ai/babysitter
verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
a5c-ai/babysitter
state-management
STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.
a5c-ai/babysitter
git-integration
Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.
a5c-ai/babysitter
frontmatter-parsing
YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.
Didn't find tool you were looking for?