Build phase

api-and-interface-design

Guides stable API and interface design. Contract-first design, Hyrum’s Law, the One-Version Rule, error semantics, and boundary validation for REST, GraphQL, and type contracts between modules.

Use when Designing APIs, module boundaries, or public interfaces.
#api#architecture

Install just this skill

Grab it on its own via the open skills CLI, or install the whole pack.

This skill only
npx skills add addyosmani/agent-skills --skill api-and-interface-design
All skills
npx skills add addyosmani/agent-skills

How this skill is structured

Every skill follows the same anatomy - a workflow the agent follows, not a doc it reads.

  • 01 Overview What this skill does
  • 02 When to Use Triggering conditions
  • 03 Process Step-by-step workflow
  • 04 Rationalizations Excuses + rebuttals
  • 05 Red Flags Signs something’s wrong
  • 06 Verification Evidence requirements
Read the full SKILL.md