Api Patterns

This is a thinking framework for API architecture decisions, not a code generator. It walks you through choosing between REST, GraphQL, and tRPC based on your actual context, then covers the practical stuff like response envelopes, versioning strategies, auth patterns, and rate limiting. The content map and decision checklist keep you from cargo culting patterns that don't fit your use case. Includes a validator script and explicitly warns against defaulting to REST or using verbs in endpoints. Good for when you need to justify architectural choices or you're tired of inconsistent API designs across your codebase.

skills.sh installs: 1.1K
GitHub stars: 43.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add sickn33/antigravity-awesome-skills --skill api-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

API Patterns

API design decisions tied to the consumers and deployment constraints. Learn to THINK, not copy fixed patterns.

🎯 Selective Reading Rule

Read ONLY files relevant to the request! Check the content map, find what you need.

📑 Content Map

File	Description	When to Read
`api-style.md`	REST vs GraphQL vs tRPC decision tree	Choosing API type
`rest.md`	Resource naming, HTTP methods, status codes	Designing REST API
`response.md`	Envelope pattern, error format, pagination	Response structure
`graphql.md`	Schema design, when to use, security	Considering GraphQL
`trpc.md`	TypeScript monorepo, type safety	TS fullstack projects
`versioning.md`	URI/Header/Query versioning	API evolution planning
`auth.md`	JWT, OAuth, Passkey, API Keys	Auth pattern selection
`rate-limiting.md`	Token bucket, sliding window	API protection
`documentation.md`	OpenAPI/Swagger best practices	Documentation
`security-testing.md`	OWASP API Top 10, auth/authz testing	Security audits