api-design
API contract design for REST and GraphQL, covering resource shape, URL and header versioning with deprecation windows, RFC 9457 Problem Details error handling, and OpenAPI specs. Use when specifying the wire contract an endpoint exposes, choosing a versioning scheme, or standardizing error response bodies across services. Framework-agnostic protocol layer, not runtime implementation.
- License
- MIT
- Compatibility
- Claude Code 2.1.220+.
Pinned to revision 1ff988bd66da, so it is the text this page describes rather than whatever the author pushed since.
Pre-approved tools experimental
Experimental field. Support varies between clients, so this list is what the author declared, not what your client will enforce.
- Read
- Glob
- Grep
- WebFetch
- WebSearch
Files
- skills/api-design/SKILL.md
- skills/api-design/assets/asyncapi-template.yaml
- skills/api-design/assets/openapi-template.yaml
- skills/api-design/examples/fastapi-problem-details.md
- skills/api-design/examples/orchestkit-api-design.md
- skills/api-design/metadata.json
- skills/api-design/references/graphql-api.md
- skills/api-design/references/ork-delta.md
- skills/api-design/references/payload-vs-sanity.md
- skills/api-design/references/rest-patterns.md
- skills/api-design/references/telegram-bot-api.md
- skills/api-design/references/webhook-security.md
- skills/api-design/references/whatsapp-waha.md
- skills/api-design/rules/_sections.md
- skills/api-design/rules/_template.md
- skills/api-design/rules/errors-agent-facing.md
- skills/api-design/rules/framework-openapi.md
- skills/api-design/rules/framework-resource-modeling.md
- skills/api-design/rules/framework-rest-conventions.md
- skills/api-design/rules/graphql-schema.md
- skills/api-design/rules/graphql-strawberry.md
- skills/api-design/rules/grpc-service.md
- skills/api-design/rules/grpc-streaming.md
- skills/api-design/rules/messaging-integrations.md
- skills/api-design/rules/payload-cms.md
- skills/api-design/rules/streaming-sse.md
- skills/api-design/rules/streaming-websocket.md
- skills/api-design/rules/versioning-header.md
- skills/api-design/rules/versioning-url-path.md
- skills/api-design/scripts/create-openapi-spec.md
- skills/api-design/scripts/fastapi-versioned-router.py
- skills/api-design/scripts/problem-detail-exceptions.py
- skills/api-design/test-cases.json
Every link opens the file at its source, pinned to the revision this page describes.