What format does Spec Writer use for acceptance criteria?

Spec Writer strictly uses the Given/When/Then (Gherkin) format to ensure that every requirement is clear, objective, and easy to translate into tests.

Can it update existing specification files?

Yes, Spec Writer can read existing Markdown files in your specs directory, allow you to modify or add criteria, and show you the changes before overwriting.

Does this skill write the actual implementation code?

No, Spec Writer is specifically for the design phase. It defines WHAT a feature should do. You should use implementation-focused skills to write the code based on the spec.

What are the rigor levels included in the specs?

It categorizes specs as spec-first (prototypes), spec-anchored (long-lived features), or spec-as-source (generated code) to help teams understand how strictly the documentation must be maintained.

How does it handle edge cases?

Based on the type of feature (like an API or a form), Spec Writer proactively suggests common edge cases such as network timeouts, invalid inputs, or unauthorized access for you to approve.

Spec Writer

Name: Spec Writer
Author: am2rican5

byam2rican5

0•

コンテンツ管理

Generates structured functional specifications using progressive elicitation and Given/When/Then acceptance criteria.

Spec Writer is a specialized capability for Claude Code designed to transform vague feature ideas into rigorous, actionable documentation. It guides users through a structured workflow to define a feature's purpose, draft Gherkin-style acceptance criteria, and proactively identify edge cases based on the feature type. By utilizing progressive disclosure, it ensures specifications are detailed without being overwhelming, providing a clear blueprint for developers while maintaining rigor through defined levels like spec-first or spec-anchored.

主な機能

01Structured Given/When/Then (Gherkin) acceptance criteria generation

02Support for updating and iterating on existing specification files

030 GitHub stars

04Standardized spec formatting with rigor level annotations

05Automated edge case suggestions for CRUD, Auth, and API features

06Progressive detail elicitation to refine requirements interactively

ユースケース

01Standardizing documentation across a development team with consistent spec structures

02Defining clear requirements and success criteria before starting code implementation

03Brainstorming potential failure modes and edge cases for security-critical features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add am2rican5/cc-plugin spec-writer

For use in Claude.ai and ChatGPT

Download Skill