Maintenance in progress: we are indexing a large batch of new skills. Some pages may load slowly or briefly show no results. Nothing is lost, and everything is back to normal within the hour.
Profile My skills Saved Collections Edit profile Submit a skill

Openapi Spec Design First Apis

[STUB - Not implemented] OpenAPI 3.1.0 design-first API specifications as single source of truth. PROACTIVELY activate for: [TODO: Define on implementation]. Triggers: [TODO: Define on implementation]

majiayu000 b4fc9f4 2 files · 2.3 KB Updated 567 repo stars
Integrations & APIs

File contents

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

majiayu000/claude-skill-registry-data/tree/main/api/openapi-spec-design-first-apis commit b4fc9f4d22

Browse category

Frequently asked questions

npx skillmds add majiayu000/openapi-spec-design-first-apis