skills.rest
Bizarre-Industries
Bizarre-IndustriesOFFICIAL
Explore all skills by this author →
WebsiteGitHub

openapi-workflow

Regenerate server and client code from OpenAPI spec changes.

Updated Apr 19, 2026
Search Tags:#automation#workflow#openapi#drift-detection#code-generation#spec-first#api-design
One-click install
npx skills add https://github.com/Bizarre-Industries/Helling --skill openapi-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openapi-workflow
Source: https://github.com/Bizarre-Industries/Helling/tree/main/.claude/skills/openapi-workflow
Command: npx skills add https://github.com/Bizarre-Industries/Helling --skill openapi-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow ensures the OpenAPI contract is the single source of truth and automates regeneration of all related client and server code.

Core Features & Use Cases

  • Spec-first design: edit api/openapi.yaml and regenerate server, client, and web-type clients with a single command.
  • Drift detection: automatically verify that generated artifacts match the spec to prevent drift in production.
  • CI-ready: integrates with existing pipelines to enforce contract-driven updates and validation.

Quick Start

Edit api/openapi.yaml, then run make generate to regenerate all artifacts.

Frequently Asked Questions about openapi-workflow

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

FAQPage Schema
How do I prevent OpenAPI spec drift in a CI pipeline?▼

You prevent OpenAPI spec drift by enforcing a spec-first workflow where make check-generated validates that server, client, and web client artifacts match the openapi.yaml contract within your CI pipeline.

What is spec-first API design and how does code generation work?▼

Spec-first API design treats the OpenAPI contract as the single source of truth. Code generation works by running a single command to automatically regenerate server, client, and web-type artifacts from the spec.

How do I regenerate server and client code from an OpenAPI yaml file?▼

To regenerate server and client code from an OpenAPI yaml file, you edit api/openapi.yaml and run make generate to synchronize all related artifacts from the updated contract.

Can I integrate OpenAPI contract validation into existing CI pipelines?▼

Yes, you can integrate OpenAPI contract validation into existing CI pipelines. The workflow is CI-ready and enforces contract-driven updates by validating generated artifacts against the spec.

Related Skills

Explore More Software Engineering Skills→
infinith4infinith4
1

api-spec

Generate OpenAPI 3.0 specifications with schemas, paths, and examples for REST APIs.

Community
Advanced
compozycompozy
182

agh-contract-codegen-coship

Enforce same-PR regeneration and consumer updates for backend API contract changes.

Official
Advanced
LiorCohenLiorCohen
39

contract-standards

Define OpenAPI contract standards and generate TypeScript types from specs.

Community
Intermediate
omniauraomniaura
17

x-integration

Automate X (Twitter) posting and engagement through WhatsApp using Playwright.

Official
Advanced