arcanea-api-design
Design APIs that developers love. RESTful principles, GraphQL patterns, versioning strategies, and the art of creating interfaces that are intuitive, consistent, and future-proof.
npx skills add majiayu000/claude-skill-registry --skill api-design-frankxai-arcanea --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# The API Design Codex > *"An API is a user interface for developers. Design it with the same care you'd design a UI for users."* --- ## The API Design Philosophy ### First Principles ``` GOOD APIs ARE: • Predictable - Behavior matches expectations • Consistent - Same patterns everywhere • Simple - Easy to use, hard to misuse • Evolvable - Can change without breaking • Documented - Self-describing where possible GOOD APIs DO NOT: • Surprise developers • Require reading implementation • Change behavior silently • Expose internal details • Force awkward workarounds ``` --- ## RESTful API Design ### The REST Maturity Model ``` ╔═══════════════════════════════════════════════════════════════════╗ ║ RICHARDSON MATURITY MODEL ║ ╠═══════════════════════════════════════════════════════════════════╣ ║ ║ ║ LEVEL 0: The Swamp of POX ║ ║ Single endpoint, RPC-style ║ ║ POST /api → {action: "getUser", id: 1} ║ ║ ║ ║ LEVEL 1: Resources ║ ║ Multiple endpoints, still mostly POST ║ ║ POST /users/1 → {action: "get"} ║ ║ ║ ║ LEVEL 2: HTTP Verbs ║ ║ Proper use of GET, POST, PUT, DELETE ║ ║ GET /users/1 ║ ║ ║ ║ LEVEL 3: Hypermedia (HATEOAS) ║ ║ Responses include links to related actions ║ ║ GET /users/1
- The API Design Philosophy
- First Principles
- RESTful API Design
- The REST Maturity Model
- Resource Naming
- HTTP Methods
- Status Codes
- Request/Response Design
- Pagination, Filtering, Sorting
- Pagination Patterns
- Filtering
- Sorting
- API Versioning
- Versioning Strategies
What does the arcanea-api-design skill do?
Design APIs that developers love. RESTful principles, GraphQL patterns, versioning strategies, and the art of creating interfaces that are intuitive, consistent, and future-proof.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-frankxai-arcanea --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.