Does this skill help with testing?

Yes, by generating Gherkin-style (Given/When/Then) acceptance criteria, it provides a clear contract that can be directly used to write unit, integration, or E2E tests.

What is the benefit of the FR/NFR numbering system?

It provides a unique ID for every requirement, making them easily traceable throughout the development lifecycle and during testing or QA phases.

How does the Spec Authoring skill trigger?

The skill activates automatically when it detects keywords like 'specification', 'requirements', 'user story', 'acceptance criteria', or when you are editing a 'spec.md' file.

Can I use this for API design?

Absolutely. The skill includes specific sections for API contracts, covering endpoints, request/response schemas, and HTTP status codes.

Spec Authoring Expert

Name: Spec Authoring Expert
Author: datamaker-kr

bydatamaker-kr

•

生产力与工作流

Generates structured, testable software specifications and requirements using standardized templates and quality validation.

The Spec Authoring skill transforms high-level ideas into rigorous technical documentation by automating the creation of functional and non-functional requirements, user stories, and Gherkin-style acceptance criteria. It ensures every requirement is atomic and traceable while validating against a strict quality checklist, making it an essential tool for developers and product managers who need clear, implementation-ready specifications that bridge the gap between concept and code.

主要功能

01Standardized requirement numbering (FR/NFR-XXX)

02User story decomposition using the As-a/I-want/So-that format

03Comprehensive quality validation against a 10-point checklist

04Technical documentation for API contracts and data models

051 GitHub stars

06Gherkin-style acceptance criteria (Given/When/Then)

使用场景

01Refining ambiguous user requirements into testable technical criteria

02Drafting a comprehensive spec.md for a new feature from scratch

03Standardizing project documentation to ensure consistency across a team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add datamaker-kr/synapse-claude-marketplace spec-authoring

For use in Claude.ai and ChatGPT

Download Skill