Api Designer

A solid reference for designing REST and GraphQL APIs that actually covers the details that matter. It walks you through resource naming, HTTP method semantics, status codes, pagination patterns, and GraphQL schema design with connection types. The before-and-after examples for REST endpoints are helpful for avoiding common mistakes like POST /getUsers. Includes practical bits like rate limiting headers, versioning strategies, and cursor-based pagination for GraphQL. The hook to a self-improving agent for learning from design patterns is interesting, though you'll want to verify those scripts actually exist in your setup. Good for standardizing API design across a team or just having sensible defaults when you're starting fresh.

Install to Claude Code

npx -y skills add charon-fan/agent-playbook --skill api-designer --agent claude-code