Openapi generator

Skill a5c-ai/babysitter/library/specializations/code-migration-modernization/skills/openapi-generator

Generate OpenAPI specifications from code or legacy APIs with schema inference and documentationFrom its SKILL.md

Install

npx -y skills add a5c-ai/babysitter --skill openapi-generator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.7 KB, 524 tokens by cl100k_base, as published. Nobody here has run it

OpenAPI Generator Skill

Generates OpenAPI specifications from code annotations, legacy APIs, or runtime analysis, with schema inference and documentation generation.

Purpose

Enable API documentation for:

Spec generation from code
Schema inference
Example generation
Validation rule extraction
Documentation generation

Capabilities

1. Spec Generation from Code Annotations

Parse JSDoc/Swagger annotations
Extract from decorators
Process code comments
Support multiple languages

2. Schema Inference

Infer from TypeScript types
Extract from runtime samples
Build from database models
Derive from existing payloads

3. Example Generation

Generate realistic examples
Create edge case samples
Produce validation examples
Build test fixtures

4. Validation Rule Extraction

Extract validation constraints
Document required fields
Map format rules
Export enum values

5. Versioning Support

Track API versions
Generate diff between versions
Document breaking changes
Support multiple versions

6. Documentation Generation

Generate Swagger UI
Create ReDoc pages
Export to Postman
Build developer portals

Tool Integrations

Tool	Language	Integration Method
Swagger Codegen	Multi	CLI
OpenAPI Generator	Multi	CLI
springdoc	Java/Spring	Library
NSwag	.NET	CLI
tsoa	TypeScript	CLI
FastAPI	Python	Auto

Output Schema

{
  "generationId": "string",
  "timestamp": "ISO8601",
  "specification": {
    "openapi": "string",
    "info": {},
    "paths": {},
    "components": {}
  },
  "artifacts": {
    "specFile": "string",
    "docsUrl": "string",
    "postmanCollection": "string"
  },
  "coverage": {
    "endpoints": "number",
    "documented": "number",
    "schemasGenerated": "number"
  }
}

Integration with Migration Processes

api-modernization: Spec generation
documentation-migration: API docs

Related Skills

api-inventory-scanner: Endpoint discovery
api-compatibility-analyzer: Version comparison

Related Agents

api-modernization-architect: API design
documentation-migration-agent: Doc generation

What ships with it: 1 file

1.4 KB alongside SKILL.md

README.md1.4 KB