Can I generate a single document instead of the whole set?

Yes, you can use specific commands like /spec-vision, /spec-brs, or /spec-architecture to focus on a single artifact, or use /spec for a full walkthrough.

What documentation frameworks does this skill support?

The skill follows industry-standard frameworks including ISO 29148, IEEE 830, IREB CPRE, Domain-Driven Design (DDD), the C4 model, and BDD/Specification by Example.

Does it help with technical design decisions?

Yes, the /spec-architecture command guides you through creating Architecture Decision Records (ADRs) and mapping them to Architecturally Significant Requirements (ASRs).

How does the skill handle different project types?

It provides context-aware suggestions; for example, it will suggest HIPAA constraints for healthcare projects or MoSCoW prioritization for startup MVPs.

What format are the documents generated in?

All documents are output as polished Markdown files, suitable for version control in your repository or conversion to PDF/HTML.

Software Spec Writer

Name: Software Spec Writer
Author: florianbuetow

byflorianbuetow

•

Learning & Documentation

Guides users through creating professional, industry-standard software specification and requirements documents using evidence-backed frameworks.

Software Spec Writer is an expert-led interactive skill designed to streamline requirements engineering for greenfield projects. It utilizes established standards such as ISO 29148, IEEE 830, and the C4 model to lead users through a structured interview process. The skill produces five distinct document types—Vision, Business Requirements (BRS), Software Requirements (SRS), Architecture & Design, and Behavioral Test Plans—ensuring complete traceability from high-level business goals to technical implementation details. By providing context-aware suggestions and enforcing measurable criteria, it helps teams prevent scope creep and align stakeholders before development begins.

Key Features

014 GitHub stars

02Layered documentation suite covering Vision, BRS, SRS, Architecture, and Test Verification.

03Interactive guided interview model with selectable options and smart defaults for different domains.

04Framework-aligned output based on ISO 29148, IEEE 830, C4, and DDD best practices.

05Automatic traceability mapping to link business goals directly to functional requirements.

06Support for Architecture Decision Records (ADRs) and Specification by Example (BDD).

Use Cases

01Documenting complex system architectures and design trade-offs for technical teams.

02Standardizing requirements engineering for a new enterprise software project.

03Translating vague stakeholder needs into measurable, testable software requirements.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add florianbuetow/claude-code spec-writer

For use in Claude.ai and ChatGPT

Download Skill