api
Installation
SKILL.md
api
Layer 1 — Domain Foundation (v2.0)
Corrects the 13 most common API design mistakes agents make, grounded in 5 authoritative sources:
- Geewax (API Design Patterns) — cursor pagination, error structure, idempotency, request deduplication
- Amundsen (RESTful Web API Cookbook) — PUT for idempotent creates, HTTP method semantics
- Ousterhout (Philosophy of Software Design) — information hiding, define errors out of existence, different layer/different abstraction
- Kleppmann (Designing Data-Intensive Applications) — network failures are normal, batch processing, data integrity
- Gough/Bryant (Mastering API Architecture) — schema validation, API lifecycle, backward compatibility, deprecation