api-spec-generator

Detect API changes and regenerate OpenAPI specs and Bruno collections.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/Shockwave2k/team-claude-skills --skill api-spec-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-spec-generator
Source: https://github.com/Shockwave2k/team-claude-skills/tree/main/skills/backend/api-spec-generator
Command: npx skills add https://github.com/Shockwave2k/team-claude-skills --skill api-spec-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically detects API surface changes and regenerates/updates OpenAPI specifications and Bruno test collections so API docs stay in sync with code.

Core Features & Use Cases

  • Detects changes across tRPC routers, REST endpoints, and GraphQL schemas.
  • Generates and merges OpenAPI 3.x specs for multiple services, along with Bruno collections for testing.
  • Keeps docs current during CI/CD and feature branches, enabling automated validation and client code generation.

Quick Start

Run the skill against a service repository to generate an up-to-date openapi.yaml and Bruno collection.

Frequently Asked Questions about api-spec-generator

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

FAQPage Schema
How do I keep OpenAPI specs in sync with code changes automatically?

To keep OpenAPI specs in sync with code changes automatically, parse API definitions directly from source code to detect surface changes and merge updates into openapi.yaml. This ensures documentation accurately reflects the latest tRPC, REST, or GraphQL implementations.

Can I generate Bruno collections from an existing OpenAPI specification?

Yes, you can generate Bruno collections from an existing or updated OpenAPI specification. By parsing your API definitions and regenerating the spec, the process outputs Bruno files for testing alongside the updated openapi.yaml file.

Does API documentation generation work with tRPC and GraphQL?

Yes, API documentation generation works with tRPC and GraphQL. The process detects changes across tRPC routers, REST endpoints, and GraphQL schemas, then generates and merges OpenAPI 3.x specs for these multiple service types.

What is the best way to update REST endpoint docs during CI/CD?

The best way to update REST endpoint docs during CI/CD is to run an automated detection process against your service repository. This parses API changes from code, merges updates into openapi.yaml, and outputs Bruno collections plus changelog entries.

Do I need a specific backend language to automate OpenAPI spec generation?

No, you do not need a specific backend language to automate OpenAPI spec generation. The process applies across Node.js, Go, and Python backends, allowing you to parse definitions and keep docs aligned with code regardless of these stacks.

Why do my Bruno test collections keep failing to match updated API endpoints?

Your Bruno test collections fail to match updated API endpoints because they are out of sync with code changes. Regenerating Bruno files by parsing the latest API definitions ensures your test collections align with the current OpenAPI spec.