Openapi

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

OpenAPI/Swagger specification, code generation, documentation, and validation.From its SKILL.md

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.

SKILL.md

1.7 KB, 295 tokens by cl100k_base, 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

What ships with it: 1 file

537 B alongside SKILL.md

README.md537 B