api-design

Installation
SKILL.md

API Design

Use this skill to turn a vague integration idea, backend feature, or service boundary into a stable API contract that other skills can build on.

The job is not to generate pretty docs. The job is to:

  • choose the right API style for the problem
  • define resources, operations, inputs, outputs, and failure semantics
  • make compatibility and versioning decisions explicit
  • produce a contract artifact that implementation, testing, and documentation can share
  • surface tradeoffs before the team hardens the wrong interface

Read references/contract-review-checklist.md and references/boundary-guide.md before handling unusual or high-risk API work.

If the user mainly needs:

Related skills
Installs
9
GitHub Stars
2
First Seen
Mar 11, 2026