Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From sage
Corrects the 13 most common API design mistakes agents make — grounded in Geewax, Amundsen, Ousterhout, Kleppmann, and Gough/Bryant
npx claudepluginhub xoai/sage --plugin sageHow 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)**
Guides REST API design with best practices for HTTP methods, status codes, structured errors, pagination, versioning, and OpenAPI documentation.
Indexes 12 RESTful API design principle skills covering routes, HTTP methods, errors, auth, versioning, webhooks, and more; invokes relevant ones before API work begins.
Share bugs, ideas, or general feedback.
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.