Babysitter openapi-generator

Generate OpenAPI specifications from code or legacy APIs with schema inference and documentation

install

source · Clone the upstream repo

git clone https://github.com/a5c-ai/babysitter

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/a5c-ai/babysitter "$T" && mkdir -p ~/.claude/skills && cp -r "$T/library/specializations/code-migration-modernization/skills/openapi-generator" ~/.claude/skills/a5c-ai-babysitter-openapi-generator && rm -rf "$T"

manifest: library/specializations/code-migration-modernization/skills/openapi-generator/SKILL.md

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