Skip to content

CODE-SAURABH/OpenSkills / api-design

api-design

Verified

Design production-grade APIs — REST, GraphQL, gRPC, and WebSocket — with a focus on consistency, versioning, error standards, and developer experience. Use when the user asks to design an API, define endpoints, choose between REST and GraphQL, structure request/response schemas, handle API versioning, design pagination, or produce an OpenAPI/Swagger spec.

FileKindSize
SKILL.mdskill md15.3 KB
references/openapi-review.mdmarkdown771 B

references/openapi-review.md

View on GitHub
# OpenAPI Contract Review

- Give every operation a stable `operationId`, summary, tags, and explicit success and error responses.
- Define reusable request, response, error, and pagination schemas under `components`.
- Mark required properties, formats, bounds, enums, nullability, and examples accurately.
- Specify authentication and authorization expectations per operation.
- Document cursor semantics, sort order, filtering, idempotency, and rate-limit responses where applicable.
- Treat removing a field, narrowing a type, changing authentication, or changing observable behavior as a compatibility review trigger.

Validate the document with the generator or linter used by the target project; a syntactically valid contract can still be behaviorally incorrect.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall