
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.
A well-crafted reference skill covering API and interface design principles — contract-first patterns, error semantics, pagination, naming conventions, and TypeScript patterns. No scripts; pure instructional content with excellent code examples and clear verification checklist. Thorough coverage of Hyrum's Law, discriminated unions, branded types, and common rationalizations.
No scripts to test — static analysis only. SKILL.md is comprehensive and well-structured. Could benefit from a references/ directory for deeper reading links. Frontmatter is clean and complete.