What is the primary purpose of the openspec-main-spec-format skill?

It enforces a specific directory and file structure for OpenSpec projects, ensuring documentation is split into normative tests (spec.md) and contextual features (feature.md).

How does this skill handle documentation linking?

It promotes and validates the use of relative markdown links between sibling files and across different capabilities to maintain a cohesive documentation web.

What content belongs in the feature.md file?

The feature.md file contains the broader context, including architecture descriptions, entities, interfaces, constraints, and usage workflows.

What content belongs in the spec.md file?

The spec.md file is reserved for normative tests, specific requirements, and high-level purpose statements, keeping the core requirements lean and focused.

OpenSpec Format Enforcer

Name: OpenSpec Format Enforcer
Author: timurb

bytimurb

0•

Learning & Documentation

Enforces standardized OpenSpec specification structures by organizing requirements and architecture into dedicated markdown files.

The OpenSpec Format Enforcer skill automates the creation and maintenance of standardized technical documentation within OpenSpec projects. By enforcing a split-file architecture—separating normative tests in spec.md from contextual architecture and workflows in feature.md—it ensures that specifications remain lean, navigable, and consistent. This skill is ideal for teams needing to maintain high-quality documentation that distinguishes between 'what' a system must do and 'how' it is structured, while managing complex cross-capability dependencies through standardized markdown linking.

Key Features

01Ensures documentation consistency across OpenSpec capabilities

02Enforces split-file format (spec.md vs. feature.md)

03Manages cross-capability markdown linking

040 GitHub stars

05Automates normative test structure in spec.md

06Standardizes architecture and workflow documentation

Use Cases

01Improving documentation discoverability through consistent internal linking

02Separating normative requirements from implementation context in documentation

03Standardizing technical specifications for large-scale software architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add timurb/cli2docker openspec-main-spec-format

For use in Claude.ai and ChatGPT

Download Skill