Openapi

Skill a5c-ai/babysitter/library/specializations/web-development/skills/openapi

Babysitter enforces obedience on agentic workforces and enables them to manage extremely complex tasks and workflows through deterministic, hallucination-free self-orchestration

Install

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

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

What its author says it does

Copied from the file, not written here

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

SKILL.md

1.7 KB, as published. Nobody here has run it

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