How does this integrate with BDD workflows?

It can automatically generate Gherkin feature files and test scenarios directly from your OpenSpec definitions, ensuring tests and specs never drift apart.

How does the OpenSpec skill auto-activate?

The skill activates automatically whenever Claude detects an 'openspec/' directory in your project or when you initiate API-related development tasks.

What is the OpenSpec philosophy?

OpenSpec treats API specifications as living documents that evolve iteratively alongside code development, rather than being rigid, frozen documents created entirely upfront.

Can I use this with existing OpenAPI files?

Yes, it is designed to manage OpenAPI 3.x specifications, adding a layer of workflow management and iterative versioning to your existing API design process.

What are status markers in OpenSpec?

Status markers like DRAFT, WORKING, and STABLE are used within the YAML spec to indicate whether an endpoint is a conceptual idea, currently being built, or ready for production.

OpenSpec Integration

Name: OpenSpec Integration
Author: TomazWang

byTomazWang

0•

API Development

Enables fluid and iterative API specification management to keep documentation perfectly in sync with active development.

The OpenSpec Integration skill transforms API design from a rigid, waterfall process into a living, iterative workflow within Claude Code. It allows developers to start with minimal drafts that evolve as implementation insights are gained, using status markers like DRAFT, WORKING, and STABLE to clearly communicate the maturity of specific endpoints. By auto-detecting OpenSpec directory structures, it seamlessly bridges the gap between design and implementation, ensuring that OpenAPI specifications remain accurate, maintainable, and tightly coupled with the codebase throughout the entire development lifecycle.

Key Features

01Auto-detection of OpenSpec directory structures and API specification files

02Seamless integration with Spec-Driven Development (SDD) and BDD workflows

03Granular status markers (DRAFT/WORKING/STABLE) for individual endpoint maturity

04Automated generation of BDD scenarios and boilerplate from current API schemas

05Iterative versioning system to track API evolution from initial draft to production

060 GitHub stars

Use Cases

01Refining complex API endpoints iteratively during the implementation and TDD phase

02Maintaining living documentation that evolves automatically alongside rapid code changes

03Starting new projects with a fluid-first API design approach rather than rigid upfront specs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/agent-toolkit openspec-integration

For use in Claude.ai and ChatGPT

Download Skill