Does this skill support event-driven architectures?

Yes, it supports AsyncAPI for event-driven systems as well as OpenAPI for standard RESTful services.

How does it ensure the implementation matches the spec?

It enforces a workflow where implementation is done against the spec and verified through contract tests to ensure compliance with the defined schema.

Can it generate code automatically?

Yes, the skill is designed to help generate server stubs, client SDKs, and contract tests directly from your validated specification.

What happens if I try to write code before the spec?

The skill will detect the implementation attempt and block it, prompting you to define an OpenAPI or AsyncAPI specification first.

Spec-Driven API Development

Name: Spec-Driven API Development
Author: TomazWang

byTomazWang

0•

API Development

Enforces a specification-first approach to API development using OpenAPI and AsyncAPI to ensure contract consistency.

This skill automates the 'Spec-First' methodology for API development, requiring developers to define OpenAPI or AsyncAPI contracts before writing implementation logic. By treating the specification as the single source of truth, it facilitates the generation of server stubs, client SDKs, and contract tests while preventing breaking changes and ensuring all endpoints are documented and validated before code is even written.

Key Features

01Mandatory specification-first workflow enforcement

020 GitHub stars

03Automated OpenAPI and AsyncAPI syntax validation

04Generation of server stubs and client SDKs from specs

05Automated contract testing against implementation

06Detection of breaking changes during the design phase

Use Cases

01Maintaining consistency between documentation and backend logic

02Designing robust REST or GraphQL APIs from scratch

03Preventing accidental breaking changes in microservice architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/agent-toolkit spec-driven-development

For use in Claude.ai and ChatGPT

Download Skill