What is required before running the /specify command?

You should first run a brainstorm command to ensure an 'idea.md' file exists, as the specify skill uses this as its primary context.

Does this skill write actual implementation code?

No, the specify skill is strictly for planning and documentation; it adheres to a rule of not writing any implementation files.

Why does it use 'MUST' and 'MUST NOT' language?

This RFC-style language ensures that all requirements are unambiguous and testable, providing a clear path for verification during the testing phase.

What is the main output of the specify skill?

It generates a 'spec.md' file containing five key sections: Overview, User Scenarios, Core Requirements, Technical Details, and a Testing Plan.

How does the skill ensure technical accuracy?

It spawns an explorer agent to analyze your existing codebase, API contracts, and data models before drafting the technical details of the spec.

Feature Specification Writer

Name: Feature Specification Writer
Author: mildsalmon

bymildsalmon

0•

Collaboration Tools

Transforms brainstormed ideas into structured, technical specifications through interactive clarification and codebase analysis.

The specify skill streamlines the transition from raw feature ideas to implementation-ready technical documentation. By conducting a clarification interview and analyzing the existing codebase, it generates a comprehensive 'spec.md' file that includes user scenarios, core requirements, and a detailed testing plan. This skill ensures that all requirements are testable and unambiguous, preventing scope creep and technical debt by establishing a clear source of truth before development begins.

Key Features

010 GitHub stars

02Automated codebase analysis to identify affected API contracts and data models

03Strict enforcement of testable requirement language using MUST/MUST NOT terminology

04Standardized 5-section specification drafting (Overview, Scenarios, Requirements, Tech, Testing)

05Interactive clarification interviews to resolve scope boundaries and technical constraints

06Seamless integration with prior brainstorming outputs for continuous workflow

Use Cases

01Converting a rough feature concept into a detailed technical requirement document

02Mapping the impact of a new feature on existing system architecture and data models

03Establishing a clear 'definition of done' and testing strategy before writing code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mildsalmon/taco-harness specify

For use in Claude.ai and ChatGPT

Download Skill