What is the Canonical Specification Format?

It is a provider-agnostic, YAML-based intermediate representation for software requirements designed to bridge different specification tools and standards like Gherkin or EARS.

Does this skill support EARS patterns?

Yes, it validates requirements against EARS types including ubiquitous, state-driven, event-driven, unwanted, complex, and optional patterns.

How are specifications validated?

The skill checks for required fields like IDs (SPEC-XXX), minimum character counts for problem descriptions, valid ISO 8601 dates, and specific enum values for status and priority.

Can I map this format to other tools?

Yes, the canonical format serves as a central hub for transformations between providers like Gherkin, SpKit, and ADRs.

Canonical Spec Format

Name: Canonical Spec Format
Author: melodic-software

bymelodic-software

•

学習とドキュメンテーション

Standardizes software requirements using a provider-agnostic YAML schema for structured, validated specifications.

This skill provides a comprehensive reference and validation framework for the Canonical Specification Format, an intermediate representation defined in ADR-115. It enables developers to create, validate, and map requirements between different formats (such as Gherkin or EARS) while maintaining a consistent structure across identifiers, MoSCoW priorities, and metadata. It is an essential tool for teams practicing spec-driven development who require a single, machine-readable source of truth for features, bugs, and technical debt.

主な機能

01Provides schema-based validation for specification IDs and metadata

02Supports MoSCoW priority classification for requirement management

03Facilitates provider-agnostic mapping between various documentation formats

04Includes built-in traceability for ADRs, Epics, and User Stories

055 GitHub stars

06Enforces EARS (Easy Approach to Requirements Syntax) pattern validation

ユースケース

01Standardizing diverse project documentation into a single machine-readable format

02Validating complex requirements against strict architectural patterns and schema constraints

03Generating consistent specification structures for feature requests and technical debt tracking

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins canonical-spec-format

For use in Claude.ai and ChatGPT

Download Skill