Babysitter openapi

OpenAPI/Swagger specification, code generation, documentation, and validation.

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/web-development/skills/openapi" ~/.claude/skills/a5c-ai-babysitter-openapi && rm -rf "$T"

manifest: library/specializations/web-development/skills/openapi/SKILL.md

OpenAPI Skill

Expert assistance for creating OpenAPI specifications and API documentation.

Capabilities

Write OpenAPI 3.x specifications
Generate client/server code
Create interactive documentation
Validate API contracts
Design request/response schemas

Usage

Invoke this skill when you need to:

Document REST APIs
Generate API clients
Validate API contracts
Create interactive docs

Specification Pattern

openapi: 3.0.3
info:
  title: Users API
  version: 1.0.0

paths:
  /users:
    get:
      summary: List users
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserList'

components:
  schemas:
    User:
      type: object
      required: [id, name, email]
      properties:
        id:
          type: string
        name:
          type: string
        email:
          type: string
          format: email

Best Practices

Use $ref for reusable schemas
Document all responses
Include examples
Version your specs

Target Processes

api-documentation
api-design
client-generation