spec

Manage OpenSpec specifications through browse, create, edit, validate, and format workflows.

5|1|Updated Dec 29, 2014
One-click install
npx skills add https://github.com/iheitlager/dotfiles --skill spec-iheitlager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/iheitlager/dotfiles/tree/main/claude/config/skills/spec
Command: npx skills add https://github.com/iheitlager/dotfiles --skill spec-iheitlager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec management and governance for creating, browsing, validating, and tracing system specifications across projects.

Core Features & Use Cases

  • Interactive browsing and listing of specs
  • Create, edit, validate, format, and convert specs to GitHub issues
  • Maintain delta specs, ADRs, and traceability across the spec lifecycle

Quick Start

Describe your system details and I will generate a complete OpenSpec workflow to get you started.

Frequently Asked Questions about spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage OpenSpec specifications across multiple projects?

To manage OpenSpec specifications, you browse, create, edit, validate, and format system specs. This workflow maintains delta specs, ADRs, and link-based traceability across multiple projects.

How do I enforce RFC 2119 compliance in system requirements documentation?

Enforcing RFC 2119 compliance requires validation workflows that check structured sections in your specifications. This ensures consistent requirement traceability and proper specification governance across the lifecycle.

What is the best way to maintain delta specs and ADRs?

Maintaining delta specs and ADRs is best handled through a dedicated spec-management workflow. This approach applies structured sections and link-based traceability to connect related specs, implementations, and tests.

Can I convert validated specifications into GitHub issues?

Yes, you can convert validated specifications into GitHub issues. This conversion happens after creating and validating your specs, allowing teams to bridge system requirements with project tracking.

How do I set up traceability between system requirements and tests?

Traceability between system requirements and tests is set up using link-based references within OpenSpec. This creates verifiable connections across implementations, tests, and related delta specs or ADRs.

Do I need structured sections for OpenSpec validation?

Yes, structured sections are required for OpenSpec validation. The validation process enforces these sections alongside RFC 2119 compliance to ensure proper documentation and spec governance.