Stats
Actions
Tags
From sage
Corrects 13 common API design mistakes with patterns and code examples from authoritative sources. Use when building RESTful APIs to avoid errors in pagination, idempotency, error envelopes, and versioning.
How this skill is triggered — by the user, by Claude, or both
Slash command
/sage:apiThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Layer 1 — Domain Foundation (v2.0)**
Layer 1 — Domain Foundation (v2.0)
Corrects the 13 most common API design mistakes agents make, grounded in 5 authoritative sources:
| Type | Count | Coverage |
|---|---|---|
| Patterns | 13 | Error envelope, input validation, cursor pagination, batch queries, auth-first, URL conventions, rate limiting, idempotent writes, separate representation, versioning, HTTP status codes, structured logging, health endpoints |
| Anti-patterns | 9 | Inconsistent errors, trusting input, returning all records, N+1 loops, bolt-on auth, non-idempotent creates, leaking DB internals, 200-with-error-body, no versioning plan |
| Constitution | 11 | principles |
Every pattern includes code examples showing wrong vs right approaches. Every anti-pattern includes root cause explaining WHY agents default to the wrong behavior.
npx claudepluginhub xoai/sageEstablishes REST API design patterns for resource naming, HTTP methods and status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.
Indexes 12 RESTful API design principle skills covering routes, HTTP methods, errors, auth, versioning, webhooks, and more; invokes relevant ones before API work begins.