Shelves Architecture & codebase
API design
476 rows from 232 repositories
Designing the interface before implementing behind it.
What API design skills agree on
203 skill files read, by 224 of the 224 authors on this shelf whose files we hold, 2026-09-06
The middle one of the 35 measured here is ~1.7k tokens long, counted with cl100k_base
Counted by distinct author, so one author publishing three of these counts once. Where a claim sits in fewer files than authors, that is said: a claim held by forty authors across three files is one file people copied, not forty people who agreed. Near-identical wordings are grouped and the other wordings are shown, so the grouping is yours to check.
What they tell the agent to do
- Use plural nouns for resource names50 of 224 in 49 filesalso worded as Use plural nouns for resource paths; Use plural nouns for resource naming
- Implement pagination for all list endpoints42 of 224 in 32 filesalso worded as Implement pagination for list endpoints; Implement pagination for all collection endpoints
- Use cursor-based pagination for large datasets42 of 224 in 40 filesalso worded as Use cursor-based pagination for GraphQL; use cursor-based pagination by default
- Return appropriate HTTP status codes for all responses31 of 224 in 21 filesalso worded as Return appropriate HTTP status codes; Use standard HTTP status codes for responses
- Use URL path versioning for API changes29 of 224 in 19 filesalso worded as use URL path versioning; Use URL versioning for API evolution
- Use HTTP methods semantically for CRUD operations22 of 224 in 13 filesalso worded as use standard HTTP methods for CRUD operations; Use HTTP methods semantically for resource operations
- Use HTTP methods for resource actions20 of 224 in 18 filesalso worded as Use standard HTTP methods for resource operations; Use HTTP methods to define actions
- Use plural nouns in kebab-case for resource URLs18 of 224 in 9 filesalso worded as Use plural nouns and kebab-case for URLs; use plural kebab-case nouns for resources
- Enforce authentication and authorization on all resources17 of 224 in 7 filesalso worded as Enforce authentication and authorization on every endpoint; Enforce authentication on all endpoints
- Use standard HTTP status codes17 of 224also worded as Use standard HTTP status codes for error responses; use standard HTTP status codes correctly
- Validate all incoming request data against a schema16 of 224 in 7 filesalso worded as Validate every response against the OpenAPI schema; validate incoming GraphQL queries against the schema
- Limit URL nesting to two levels16 of 224also worded as Limit nested paths to two levels; Limit nested routes to two levels
- Include Location header for created resources15 of 224 in 6 files
- Configure rate limiting for all API endpoints15 of 224 in 6 filesalso worded as Rate limit all API endpoints; Configure rate limiting for all endpoints
- Use kebab-case for multi-word paths15 of 224also worded as use kebab-case for multi-word resources; Use kebab-case for URL paths
What they tell it not to do
- Do not use verbs in resource URLs66 of 224 in 56 filesalso worded as Do not use verbs in URLs; Do not use verbs in URL paths
- Do not return 200 OK for all responses34 of 224 in 25 filesalso worded as Do not return 200 status codes for errors; Do not return 200 OK for error responses
- Do not expose internal server error details21 of 224 in 12 filesalso worded as do not expose internal server details in errors; do not expose internal details in error messages
- Do not use singular nouns for resources20 of 224 in 11 files
- Do not use snake_case in URLs20 of 224 in 11 filesalso worded as Do not use snake_case in JSON bodies; do not use snake_case for URLs
- Do not expose stack traces in production12 of 224 in 11 filesalso worded as never expose stack traces or internal paths; do not expose stack traces or internal system details
- Do not make breaking changes without versioning10 of 224also worded as Do not make breaking changes in minor versions; Do not make breaking changes to existing versions
- Do not expose internal IDs9 of 224 in 8 filesalso worded as Do not expose internal database structures; Do not expose internal details
- Do not use offset-based pagination9 of 224also worded as Do not use offset pagination for external consumers; Do not use offset pagination for mutable data
- Do not return error bodies with 200 status codes9 of 224also worded as Do not return 200 for error states; do not use 200 status code for everything
What they expect to be installed
- OpenAPI65 of 224 in 52 files
- Swagger38 of 224 in 27 files
- Zod30 of 224 in 21 files
- Pydantic19 of 224 in 10 files
- grep10 of 224
- Spectral10 of 224
- GraphQL9 of 224
- Pact9 of 224
- DataLoader9 of 224 in 8 files
- Django8 of 224 in 3 files
What they ask it to produce
- OpenAPI specification56 of 224 in 45 filesalso worded as API specifications; OpenAPI specification file
- API documentation47 of 224 in 36 filesalso worded as OpenAPI documentation; API design documentation
- API endpoint design29 of 224 in 19 filesalso worded as API endpoints; API endpoint definitions
- API contract18 of 224also worded as API contract documentation; API contracts
- GraphQL schema17 of 224 in 15 filesalso worded as schema.graphql; GraphQL schemas
- Custom middleware9 of 224 in 4 filesalso worded as middleware
- Custom QuerySets8 of 224 in 3 files
- Service layer classes8 of 224 in 3 files
When API design authors say to reach for one
The situations these authors wrote into their own files, counted out of the same 224 authors, with the skills that name each one
- Designing new API endpoints50 of 224 in 39 files
- Api design
- Api design review
- Ecc api design
- and 16 more on this shelf
- Reviewing existing API contracts27 of 224 in 17 files
- Api design
- Ecc api design
- and 16 more on this shelf
- Designing an API26 of 224
- Planning API versioning strategy24 of 224 in 15 files
- Api design
- Ecc api design
- and 15 more on this shelf
- Adding pagination, filtering, or sorting23 of 224 in 14 files
- Api design
- Ecc api design
- and 13 more on this shelf
- Implementing error handling for APIs22 of 224 in 13 files
- Api design
- Ecc api design
- and 13 more on this shelf
- Building public or partner-facing APIs20 of 224 in 11 files
- Api design
- Ecc api design
- and 13 more on this shelf
- API versioning19 of 224
How API design skills are built
433 skill directories by 214 authors, read from their repositories’ own file trees 2026-08-05
The middle bundle among those shipping files is 3 files, 21.0 KB beside SKILL.md
Counted by distinct author, same as above, so one author publishing forty template copies counts once. SKILL.md itself is not counted as a file, so a single-file skill is one where that file is the whole skill.
The shape
- SKILL.md is the whole skill106 of 214 authors, 233 of 433 skills
- files ship beside it108 of 214 authors, 200 of 433 skills
- executable scripts ship inside32 of 214 authors, 48 of 433 skills
The folders they converge on
- references/71 of 214 authors, 108 of 433 skills
- assets/23 of 214 authors, 32 of 433 skills
- scripts/15 of 214 authors, 19 of 433 skills
- agents/13 of 214 authors, 18 of 433 skills
- evals/13 of 214 authors, 23 of 433 skills
- templates/10 of 214 authors, 17 of 433 skills
decebals/claude-code-java/.claude/skills/api-contract-review Skill
703★ repoReusable AI development infrastructure for Java projects, optimized for Claude Code
margelo/react-native-skills/skills/api-design Skill
no license154★ repoThe best react-native Agent Skills. Forget 10x, this is 100x.
AsyrafHussin/agent-skills/skills/api-design-patterns Skill
62★ repoAgent skills for AI coding agents (Claude Code, Cursor, Codex, Windsurf) — Laravel, React, TypeScript, MySQL, code quality, technical debt, documentation, and security.
proyecto26/system-design-skills/skills/api-design Skill
46★ repoA divide-and-conquer wiki of system-design skills for Claude Code — reason about scalable systems, don't memorize architectures.
robisson/build-like-amazon-agent-skills/skills/api-contract-first Skill
13★ repoProduction-grade engineering skills for AI coding agents, built on Amazon Way of building services
martinholovsky/SOTA-skills/skills/sota-api-design Skill
12★ repoState-of-the-Art (2026) AI/LLM engineering skills/agents for building and auditing software — 40+ domain & language skills, BUILD/AUDIT modes, audit checklists.
wpank/ai/skills/api/api-design Skill
no license11★ repoA curated collection of 115 skills, 16 agents, and 48 commands for Claude Code and Cursor.
carlopezzuto/agents/.claude/skills/api-design-principles Skill
3★ repoClaude Code configuration with 42 specialized agents, 33 skills, 28 commands, and a hook system for development best practices
ProjAnvil/MindForge/skills/en/api-design Skill
3★ repoA comprehensive AI toolkit for Claude Code featuring multi-language agents, reusable skills, and MCP services to supercharge your development workflow
iwritec0de/app-dev/skills/api-design Skill
3★ repoFull-stack Next.js development plugin for Claude Code
ldilov/harness-forge/skills/api-contract-review Skill
3★ repoAI coding agent runtime that makes LLMs understand your codebase with repository-aware context, memory, and continuous learning
halflength-ampleness75/claude-code-recipes/skills/api-design Skill
2★ repoProvide ready-to-use Claude Code commands, subagents, hooks, skills, and configs to simplify setup and speed up development.
chrislacey89/skills/api-design-review Skill
2★ repoPipeline-first Claude Code skills pack — 19 composable skills for structured feature delivery from shape to ship
mturac/hermes-supercode-skills/skills/api-sculptor Skill
2★ repo⚡ 13 production-grade skills for Claude Code · db-whisperer, auth-architect, obs-guardian + 10 more · Zero config · MIT
ajaygodbole7/rest-api-skill/skills/api-contract-evolution Skill
no license2★ repoZalando RESTful API Guidelines reformatted as Agent Skills for AI coding agents
Noorkhalel/saas-ai-skills/skills/api-design-review Skill
1★ repoOpen-source AI Skills library for building, improving, and scaling modern SaaS applications.
shandar/pwp-plugin/skills/pwp-api-design Skill
1★ repo11 systematic skills for Claude Code — structured protocols for debugging, code review, security, refactoring, testing, deployment, and more. No vibes, just discipline.
0xc000022070/agentic-flake/examples/3-home-manager/skills/api-design Skill
no license1★ repoComposable agent skills and project-scoped environments for Nix.
SkillMedev/full-stack-web-dev/skills/api-design Skill
1★ repoNext.js to Postgres — build and ship a modern web app end to end.
simanam/theaiteam/team/skills/architecture/api-design Skill
no license1★ repoReusable, provider-agnostic AI team. Drop a project brief, get end-to-end delivery. 12 role agents + 112 skills + orchestrator + self-improvement. Works with Claude Code, Codex, or Gemini.
SkillMedev/technical-writing-studio/skills/api-design Skill
1★ repoDocs people actually read — READMEs, guides, changelogs, and specs.
marktco/agentic-de-atrophy/skills/design/api-design Skill
1★ repoSkills for stronger programming practice in the AI/agent era.
aps08/fullstack-clean-architecture/.agents/skills/api_design Skill
1★ repoRead to code, just run Docker compose.
zhouhuijia/sharp-skills/skills/sharp-api-design Skill
no license1★ repoAI Agent 品控规则合集。Stop AI slop — 六个模块,七平台兼容,一行命令安装。
piyushzala158/agent-skills/api-design Skill
1★ repocollection of reusable engineering skills for AI coding agents
tunahanaliozturk/secure-dotnet-skills/skills/api-contract-review Skill
1★ repoAegis — 12 judgment-style agent skills for secure, production-grade .NET on Azure (security, design, performance, concurrency, observability). Works with Claude Code, Codex, Cursor, Gemini.
mohamedzhioua/proofguard/deferred/api-contract-guard/skill Skill
1★ repoKill-tested guard skills for AI coding agents , self-invoking quality gates that catch AI failure modes in security, tests, docs, dependencies, and diffs before the agent says "done." Works with Claude Code, Codex, and Cursor.
YouRen1320/agent-project-kit/.agents/skills/api-contract Skill
1★ repoReusable repository guidance, workflows, runbooks, and skills for people, Codex, and Claude Code.
BTN101/claude-skill-pack/skills/engineering/api-design Skill
0★ repoClaude skills organized into domain layers — engineering, product, founder/GTM, design, and documents
SkillMedev/qa-test-automation/skills/contract-test-writer Skill
0★ repoBuild a test suite that actually catches bugs — and stops flaking.
jayesh-bansal/api-design-pro Skill
no license0★Claude skill: API design intelligence - REST conventions, RFC 9457 errors, cursor pagination, idempotency keys, signed webhooks. Design APIs like Stripe, not a CRUD generator.
digitaldreams/tuhin/skills/api-contract Skill
0★ repoMy dev identity as a Claude Code plugin — a full Laravel team in a box: SDLC pipeline, task board, coding agents, and audit skills.
Baufest/skills/skills/api-design Skill
0★ repoPublic repository for a curated collection of agent skills
rynhardt-potgieter/sprint_workflow/plugins/sprint-workflow/skills/api-design Skill
0★ repoA portable Claude Code plugin system for orchestrating software development through parallel specialist agents, enforced engineering standards, and automated quality gates. One command to plan. Parallel agents to build. Automated gates to ship.
2muchcoffeecom/nestjs-manifesto/.claude/skills/nestjs-2muchcoffee Skill
0★ repoThe 2muchcoffee NestJS engineering manifesto plus drop-in agent skill files for Claude Code, Cursor, and Codex.
tyecode/skills/skills/engineering/api-design Skill
0★ repoPersonal AI agent skills for better coding. Fixes common agent failure modes: misaligned requirements, blind coding, debugging loops, and lost context between sessions.
TheophilusChinomona/idev/skills/api-contract-validation Skill
0★ repoClaude Code plugin: token-optimized dev workflow — cached project context, pattern scanners, build & wiring verification, session persistence, self-review. 23 skills, 3 agents, 4 commands.
cipradu/Agent-Workbench/skills/api-design Skill
0★ repoPortable skills, agents, and operating workflows for AI assistants.
satishTheLegend/api-contract-governor Skill
0★Governs API evolution across producer and consumers: detects breaking changes, blocks them at the gate, and orchestrates a versioned deprecation lifecycle nobody can short-circuit.
vaibhavsaxena022/skills/api-design-first Skill
0★ repoAI-agent skills for software engineering — works with Claude Code, Codex, Cursor
Gisellesleeveless396/go-agent-skills/skills/(architecture)/go-api-design Skill
0★ repoProvide Go agent skills for cleaner, idiomatic code across Claude Code, Cursor, Copilot, and more with one install
lazymac2x/api-contract-validator-api/io.github.lazymac2x/api-contract-validator MCP server
no license0★ repoCloudflare Workers MCP server: api-contract-validator
DevelopersGlobal/ai-agent-skills/skills/api-design Skill
65★ repoAI agent skills for production grade applications
OutlineDriven/odin-claude-plugin/skills/api-design Skill
34★ repoOutline-Driven Development for Claude Code - 46 agents, 25+ skills, diagram-first methodology, AST-based editing, atomic commits.
oribarilan/97/skills/api-design Skill
no license23★ repoAgent skills distilled from the hard-won lessons of world-renowned programmers, in the spirit of "97 Things Every Programmer Should Know"
ducpm2303/claude-java-plugins/plugins/java-core/skills/java-api-review Skill
no license17★ repoJava developer toolkit for Claude Code — skills, agents, hooks, and coding standards for Java 8+ projects
s-hiraoku/synapse-a2a/.agents/skills/api-design Skill
no license10★ repoviknesh20-20/claude-code-tool-kit/.claude/skills/api-design Skill
7★ repoProduction-ready Claude Code configuration. 12 original agents, 200+ slash-command skills, 45+ MCP servers, 14 plugins, design + 3D + WebGPU + GSAP + RAG tooling. One-command Node.js installer for premium websites, SaaS apps, AI agents. Free, MIT, stack-agnostic.
segunadebayo/design-eng-skills/skills/component-api-design Skill
6★ repoAgent skills for design engineers: state machine design, component API design, engineering writing, changeset writing.
pekral/cursor-rules/skills/api-review Skill
5★ repoPHP and Laravel Cursor rules — coding standards, testing, and conventions for the Cursor editor. Install via Composer.
aneja5/forge-skills/skills/api-design Skill
3★ repoAn assembly line for AI software development. 35 skills, 11 agent personas, 29 commands. From raw idea to shipped code.
atuljha23/holocron/skills/api-design Skill
2★ repoRole-aware Claude Code plugin: 10 specialist agents (frontend, backend, QA, a11y, perf, security, architect, debugger, code-reviewer, docs), 15 domain commands, 8 skills, and a SQLite-backed learning crystal that compounds your corrections across sessions.
saitarrun/sdlc-ai-workflow/skills/skill-api-design Skill
no license2★ repoA comprehensive Claude Code plugin that automates the complete Software Development Lifecycle with 20 role-specific agents, 12 knowledge skills, and 8 commands, all guided by principles.
ajaygodbole7/rest-api-skill/skills/api-contract-generation Skill
no license2★ repoZalando RESTful API Guidelines reformatted as Agent Skills for AI coding agents
hnikoloski/imlazy/skills/imlazy-api-design Skill
2★ repoToken-efficient tier-routed agent orchestrator 40+ skills, 19 agents, Obsidian vault. Works with Claude Code, OpenCode, Codex CLI.
adtn0810/truestack/skills/truestack-api-design Skill
2★ repoHonesty-first coding skill set for Claude Code — 21 skills behind an orchestrate router with an enforced governance gate, a code↔memory tally, and auto-research. Built for self-hosted work.
furkangonel/cowrangler/bundled_skills/api-design Skill
2★ repoAutonomous terminal AI agent for workflows and feasible project procedures. Co-Worker Co-Wrangler 🐙
MartinOlivero/saas-builder/skills/api-design Skill
1★ repoBuild a complete, secure SaaS end to end in Claude Code: prevention-first security (not audit), real Stripe payments (not just a catalog), and 15 lifecycle skills. Pairs with Superpowers — needs nothing else.
medy-gribkov/arcana/skills/api-design Skill
1★ repoUniversal AI development toolkit. 74 production-ready skills for every coding agent. Works with Claude Code, Cursor, Codex.
pvnarp/agent-skills/skills/api-design Skill
1★ repoSkills I use with Claude Code across my projects. Architecture, code review, testing, security, deployment, and more.