Spec Writing Patterns

Community

Write clear, testable requirements.

AuthorHermeticOrmus
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps technical writers and engineers create unambiguous, verifiable requirements and specifications, preventing costly misunderstandings and implementation errors.

Core Features & Use Cases

  • Testability: Ensures every requirement can be validated with a test case.
  • Clarity: Differentiates between mandatory ('shall'), recommended ('should'), and optional ('may') statements.
  • Structure: Provides templates for Gherkin acceptance criteria, interface contracts, and state machines.
  • Use Case: When defining a new user authentication feature, use this Skill's patterns to ensure requirements like "The system shall lock an account after 5 failed login attempts within 10 minutes" are precisely defined and testable.

Quick Start

Use the spec-writing-patterns skill to learn about the 'Shall vs. Should vs. May' pattern.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: Spec Writing Patterns
Download link: https://github.com/HermeticOrmus/LibreCopy-Claude-Code/archive/main.zip#spec-writing-patterns

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.