openspec

Manage structured requirements with Gherkin syntax and track spec deltas.

2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/hiyenwong/ai_collection --skill openspec-hiyenwong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec
Source: https://github.com/hiyenwong/ai_collection/tree/main/collection/skills/openspec
Command: npx skills add https://github.com/hiyenwong/ai_collection --skill openspec-hiyenwong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenSpec provides a structured, language-agnostic framework for capturing requirements in Gherkin syntax, reducing ambiguity and accelerating alignment between product, engineering, and QA teams.

Core Features & Use Cases

  • BDD-ready: Write requirements as GHERKIN-style rules and scenarios to drive automated tests.
  • Delta tracking: Track spec deltas to manage changes over time and propagate updates to implementations.
  • AI-assisted workflows: Integrate with AI coding agents to generate tests, scaffolding, and documentation from specs.
  • Use Case: When a product team defines a new feature, OpenSpec enables a living spec, scenario examples, and test generation.

Quick Start

Create a new OpenSpec file with a simple "Requirement" and one "Scenario" using Given-When-Then to begin the spec-driven workflow.

Frequently Asked Questions about openspec

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

FAQPage Schema
How do I write Gherkin specifications to bridge business needs and implementation?

Gherkin specifications bridge business needs and implementation by defining structured requirements using Given-When-Then scenarios. This framework captures rules and examples to drive automated tests and align product, engineering, and QA teams.

What is specification-driven development and when do I need it?

Specification-driven development is capturing requirements in Gherkin syntax to reduce ambiguity across teams. You need it when defining a new feature that requires clear specifications, testable scenarios, and automated documentation to accelerate alignment.

How do I track requirement deltas for changing software specifications?

Track requirement deltas by managing spec changes over time to propagate updates to implementations. This delta tracking mechanism ensures that modifications to Gherkin scenarios are systematically reflected in downstream automated tests and documentation.

Can I use AI coding agents to generate tests from Gherkin scenarios?

Yes, AI coding agents generate tests, scaffolding, and documentation from Gherkin scenarios. This AI-assisted workflow integrates with spec-driven development to automate the creation of implementation artifacts directly from defined requirements.

Does OpenSpec work for language-agnostic BDD automation workflows?

OpenSpec provides a language-agnostic framework for BDD automation workflows. It supports writing requirements as Gherkin-style rules and scenarios, making it suitable for diverse software projects requiring spec-driven development across different tech stacks.

What are the limitations of using Gherkin syntax for specification management?

Gherkin syntax for specification management requires strict structured formatting, which can become verbose for complex logic. Teams must maintain a living spec carefully, as improper delta tracking can cause misalignment between the written scenarios and the actual implementation.