OpenAPI Spec Design-First APIs

STUB: This skill is not yet implemented

This placeholder preserves the documented plugin structure.
See parent plugin README for planned capabilities.

Planned Capabilities

• Design-First Approach: API specification before implementation
• OpenAPI 3.1.0 Compliance: Latest specification features
• Schema component reuse and references
• Request/response examples
• Authentication scheme definitions
• API versioning strategies

Example Structure

openapi: 3.1.0
info:
  title: User API
  version: 1.0.0
paths:
  /users:
    get:
      summary: List users
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'

Anti-Patterns

• API implementation before specification
• Inconsistent error response formats
• Missing authentication documentation

Implementation Status

• Core implementation
• References documentation
• Output templates
• Integration tests