What are delta specs in the context of this skill?

Delta specs are structured requirements that describe only what is being added, modified, or removed from the system's behavior, rather than rewriting the entire domain specification from scratch.

How does the skill ensure requirements are testable?

The skill mandates a Given/When/Then format for every scenario, ensuring that each requirement has a clear precondition, action, and expected outcome that can be converted into automated tests.

Does this skill follow standard industry terminology?

Yes, it strictly adheres to RFC 2119 keywords like MUST, SHALL, and SHOULD to define the strength and necessity of each technical requirement.

What happens if a specification domain doesn't exist yet?

If the skill detects a new domain with no existing documentation, it automatically switches from writing a delta spec to generating a comprehensive Full Specification.

SDD Specification Writer

Name: SDD Specification Writer
Author: Portmeo

byPortmeo

0•

학습 및 문서화

Generates structured technical specifications and delta requirements using RFC 2119 standards and Gherkin-style scenarios.

This skill acts as a specialized sub-agent within the Claude Code environment for drafting and updating technical specifications based on project proposals. It intelligently identifies affected domains, manages 'delta specs' to clearly highlight changes (Additions, Modifications, and Removals), and ensures all requirements are testable through mandatory Given/When/Then scenarios. By enforcing RFC 2119 terminology and providing detailed coverage summaries, it bridges the gap between high-level proposals and technical implementation, ensuring system behavior is precisely documented and ready for the design phase.

주요 기능

01Delta specification generation for focused requirement updates

02Strict RFC 2119 requirement keyword enforcement (MUST, SHALL, SHOULD)

03Comprehensive coverage reporting including happy paths and edge cases

04Automatic domain detection and organization within the artifact store

05Gherkin-style Given/When/Then scenario mapping for testability

060 GitHub stars

사용 사례

01Defining testable edge cases and error states before the coding phase begins

02Maintaining living documentation with automated delta updates for complex systems

03Translating high-level feature proposals into actionable technical requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add portmeo/rag-chat-project sdd-spec

For use in Claude.ai and ChatGPT