skills.rest
TomazWang
TomazWangCOMMUNITY
Explore all skills by this author →
Website𝕏@tomazwangGitHub

spec-driven-development

Validate OpenAPI and AsyncAPI specifications and generate server stubs.

Updated Feb 5, 2026
Search Tags:#openapi#asyncapi#contract-testing#spec-first#api-development#client-sdk#server-stubs
One-click install
npx skills add https://github.com/TomazWang/agent-toolkit --skill spec-driven-development-tomazwang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/TomazWang/agent-toolkit/tree/main/plugins/sdd-workflow/skills/spec-driven-development
Command: npx skills add https://github.com/TomazWang/agent-toolkit --skill spec-driven-development-tomazwang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces API contracts before implementation to prevent mismatches and rework.

Core Features & Use Cases

  • OpenAPI/AsyncAPI specification governance and validation before implementation.
  • Automated checks for spec completeness and breaking-change detection.
  • Generation of server stubs, client SDKs, and contract tests from the spec.

Quick Start

Define your API contract with an OpenAPI or AsyncAPI spec and activate the skill to validate and generate scaffolding.

Frequently Asked Questions about spec-driven-development

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

FAQPage Schema
How does spec-first API development prevent implementation mismatches?▼

Spec-first API development prevents mismatches by validating OpenAPI or AsyncAPI specifications for completeness and breaking changes before any server stubs or client SDKs are generated. This enforces a strict contract early, eliminating downstream rework.

Can I generate server stubs and client SDKs directly from an OpenAPI specification?▼

Yes, you can generate server stubs, client SDKs, and contract tests directly from a validated OpenAPI specification. The skill automates scaffolding to ensure implementation aligns perfectly with the defined API contract.

What is the best way to detect breaking changes in an AsyncAPI spec?▼

The best way to detect breaking changes in an AsyncAPI spec is through automated spec validation checks. The skill performs completeness and breaking-change detection during the specification governance phase before any code generation occurs.

Does contract testing work with both REST and streaming endpoints?▼

Contract testing works with both REST and streaming endpoints. The skill supports spec-first workflows across OpenAPI and AsyncAPI specifications, validating contracts and generating tests for asynchronous and synchronous API implementations.

How do I validate API completeness before generating server stubs?▼

To validate API completeness before generating server stubs, define your contract with an OpenAPI or AsyncAPI spec and activate the skill. It performs automated syntax validation and completeness checks to ensure the spec is ready for scaffolding.

Related Skills

Explore More Software Engineering Skills→
papeete-consulting-labpapeete-consulting-lab

harness-backend

Generate and validate OpenAPI and AsyncAPI contract harnesses for .NET and Python microservices.

Official
Advanced
CODE-SAURABHCODE-SAURABH
2

backend-dev

Design and implement backend services and APIs with contract-first architecture and security controls.

Community
Advanced
heaptracetechnologyheaptracetechnology
13

contract-test

Automate API contract testing with schema validation and OpenAPI checks.

Community
Advanced
Harmeet10000Harmeet10000
7

openapi-spec-generation

Generate and validate OpenAPI 3.1 specifications from code or design-first specs.

Community
Advanced