# 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]

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

---


# 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

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