Menu
REST/API conventions — resource design, status codes, error shapes, validation-at-boundary. Load for any endpoint work.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | api-design |
| description | REST/API conventions — resource design, status codes, error shapes, validation-at-boundary. Load for any endpoint work. |
{ error: { code, message, details? } } — codes stable (machine-readable), messages human-readable, internals never leaked/users/:id/orders), verbs only for true actions (/auth/login)limit capped server-side; total counts only when cheapContract documented (schema is the doc) · error paths tested, not just happy path · rate limits on public endpoints · idempotency on retryable mutations.
Context engineering — memory navigation, textual graph traversal, progressive disclosure, recovery. Load when assembling context for a task or when lost.
Implementation-side security discipline — headers, dependencies, secrets, authz. Load for hardening work (sec-ops domain).
Commit conventions, branching, anchors in messages, and the git safety rules. Load for any git operation beyond status/diff.
Anti-generic-AI design discipline — bans, tells, and the slop test. Load for ANY new UI surface or visual redesign. Inspired by Impeccable (Apache 2.0).
Motion & animation discipline — purpose, performance, reduced-motion. Load when work involves animation, transitions or scroll effects.
Microcopy discipline — buttons, errors, empty/loading/success states, alt text. Voice and tone come from the project's memory, not from this skill.