Api Design Principles

This one walks you through REST and GraphQL design principles with actual code patterns you can steal. It covers the fundamentals like resource naming, HTTP method semantics, and pagination, plus GraphQL specifics like schema-first design and DataLoader for avoiding N+1 queries. The examples are concrete, from FastAPI pagination handlers to HATEOAS link structures. What I appreciate is it doesn't just list principles but shows you the pitfalls like over-fetching and tight coupling to your database schema. Use this when you're designing a new API, reviewing specs before implementation, or trying to establish standards across your team. The versioning strategies section alone could save you from future headaches.

Install to Claude Code

npx -y skills add secondsky/claude-skills --skill api-design-principles --agent claude-code