# Openapi

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

- Skill: `majiayu000/openapi-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/openapi-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/openapi-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/openapi-2

---


# 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

```yaml
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