
from agent-skills12,553
Guides design of stable, predictable APIs and interfaces — contract-first patterns, error semantics, pagination, and naming conventions for robust integrations.
Practical guidance for designing stable, well-documented APIs and component interfaces. It codifies principles (Hyrum's Law, One-Version Rule), contract-first design, consistent error semantics, validation at boundaries, and pagination/naming patterns so engineers build APIs that are hard to misuse.
Use when creating new REST/GraphQL endpoints, defining module boundaries, changing public interfaces, or establishing API contracts between teams. Helpful during API design reviews, schema decisions, and deprecation planning.
Recommended for coding/design agents that author APIs or code (Copilot/Codex/GitHub Copilot-style assistants, Claude Code, Cursor). It is useful for agents that generate or review API code and docs.
This skill has not been reviewed by our automated audit pipeline yet.