How does it handle existing projects?

It uses keyword searching to identify existing specifications and can automatically append new requirements while maintaining the existing document structure and numbering.

What documentation files does this skill manage?

The skill manages and synchronizes three primary files: spec.md (requirements), plan.md (implementation strategy), and tasks.md (actionable checklists).

Is this skill suitable for Test-Driven Development (TDD)?

Yes, it specifically includes a TDD/Test requirement check that ensures automated testing is integrated into the success criteria and the final task list.

What is the 'Clarify' step in the workflow?

The Clarify step identifies ambiguities in the initial requirements and asks the user up to five targeted questions with recommended answers to ensure the specification is complete.

Requirements Spec Kit

Name: Requirements Spec Kit
Author: akiojin

byakiojin

•

Collaboration Tools

Streamlines the software requirement definition process by automating the generation of specifications, implementation plans, and TDD-ready task lists.

The Requirements Spec Kit is a specialized tool designed to manage the full lifecycle of software requirements within the Claude Code environment. By following a structured 'Specify-Clarify-Plan-Tasks' workflow, it helps developers transition from vague ideas to concrete, actionable documentation. The skill intelligently manages file generation for spec.md, plan.md, and tasks.md, ensuring that even complex additions to existing specifications remain consistent and well-organized. It is particularly effective for teams practicing Test-Driven Development (TDD), as it mandates the inclusion of success criteria and automated testing tasks from the very beginning of the planning phase.

Key Features

01Structured four-step workflow: Specify, Clarify, Plan, and Tasks

022 GitHub stars

03TDD-ready task list generation with mandatory test coverage validation

04Template-driven generation of architectural plans and data models

05Interactive clarification process with suggested answers for rapid requirement refining

06Automated detection and updating of existing specification documents (spec.md)

Use Cases

01Creating granular, checklist-style task lists that prioritize automated testing and software quality

02Transforming high-level feature requests into detailed technical specifications and implementation plans

03Maintaining and updating existing project documentation with consistent numbering and formatting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add akiojin/gwt requirements-spec-kit

For use in Claude.ai and ChatGPT

Download Skill