{"enrichment":{"faq":[{"a":"dev-api-design teaches REST API fundamentals including resource modeling, HTTP method semantics, status codes, and contract-first approaches. The skill covers designing endpoints that follow REST principles, structuring payloads, and implementing proper HTTP semantics for CRUD operations and complex workflows.","q":"How do I design a REST API?"},{"a":"dev-api-design helps you evaluate each style: REST for simple CRUD and public APIs, GraphQL for flexible client queries and reducing over-fetching, and gRPC for high-performance internal services. The skill guides tradeoffs in complexity, caching, tooling, and team expertise to match your use case.","q":"REST vs GraphQL vs gRPC\u2014which should I use?"},{"a":"dev-api-design covers versioning approaches including URL paths, headers, and content negotiation, plus deprecation policies and breaking-change detection. It teaches how to plan API evolution, communicate changes to consumers, and maintain backward compatibility or manage controlled transitions.","q":"What are the best API versioning strategies?"},{"a":"dev-api-design guides OpenAPI spec authoring for documenting REST APIs with schemas, parameters, responses, and security definitions. The skill shows how to generate interactive documentation, validate requests against specs, and use specs for code generation and contract testing.","q":"How do I write an OpenAPI specification?"},{"a":"dev-api-design covers JWT and OAuth2 authentication patterns, API key management, and rate-limiting strategies (token bucket, sliding window). It includes authorization checks, token refresh flows, and designing rate limits that protect backend resources while respecting client needs.","q":"How should I implement authentication and rate limiting?"},{"a":"dev-api-design teaches RFC 9457 problem details format for structured error responses, HTTP status code semantics, and error recovery strategies. The skill covers logging errors for observability, communicating failures clearly to clients, and designing retry-safe operations.","q":"What error handling patterns should production APIs follow?"}],"shadow_tags":["contract-first","microservices-communication","type-safety","protocol-selection","deprecation-lifecycle","distributed-tracing","schema-validation","backward-compatibility","developer-experience"],"summary_rewrite":"Build APIs across REST, GraphQL, gRPC, and tRPC styles with contract-first design, RFC 9457 error models, and modern best practices. Covers OpenAPI specs, versioning strategies, authentication/authorization, rate limiting, pagination, and observability patterns for public and internal services."},"files":[{"bytes":14858,"path":"frameworks/shared-skills/skills/dev-api-design/SKILL.md","sha256":"6a746e1c7005a5371f8f9e3a8dc44532ab9f60a42f513f68ba3454d2bcf39bc8","url":"https://skillfed.io/files/vasilyu1983/AI-Agents-public/dev-api-design/eab63955/SKILL.md"}],"id":"vasilyu1983/AI-Agents-public/dev-api-design","links":{"html":"https://skillfed.io/vasilyu1983/AI-Agents-public/dev-api-design","md":"https://skillfed.io/vasilyu1983/AI-Agents-public/dev-api-design.md","repo":"https://github.com/vasilyu1983/AI-Agents-public"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":17,"language":"Python","last_updated":"2026-07-13","license":"MIT","name":"dev-api-design","publisher":"vasilyu1983","stars":69},"relations":{"categories":["api-development","backend-engineering","software-architecture"],"similar":[{"id":"yonatangross/orchestkit/api-design"},{"id":"curiositech/some_claude_skills/api-architect"},{"id":"vasilyu1983/AI-Agents-public/software-backend"},{"id":"majiayu000/spellbook/api-design"},{"id":"EliasOulkadi/shokunin/api-forge"},{"id":"Jeffallan/claude-skills/api-designer"},{"id":"miles990/claude-software-skills/api-design"},{"id":"bobmatnyc/claude-mpm-skills/api-design-patterns"},{"id":"martinholovsky/claude-skills-generator/api-expert"},{"id":"ancoleman/ai-design-components/implementing-api-patterns"}]},"slug":{"owner":"vasilyu1983","repo":"AI-Agents-public","skill":"dev-api-design"},"version":"eab63955"}