SKILL

api-and-interface-design

addyosmaniListed

Primary machine endpointhttps://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design

Use with an agent

SUMMARY

What it does

This Agent Skill provides guidance for designing stable APIs and interfaces, covering REST and GraphQL endpoints, module boundaries, and frontend-backend contracts. It includes principles such as contract-first design, consistent error semantics, validation at boundaries, additive changes, predictable naming, and idempotency key handling. The skill is a markdown document with no executable code or tools.

CAPABILITIES

Capabilities and scope

Evidence-backed capability profile

design.apiweight 100 · confidence 90

MACHINE-READABLE ENDPOINTS

How agents read it

REST JSONhttps://aiworkshub.io/api/v1/resources/RES_1B3D0C82433BCanonical source

https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/api-and-interface-design/SKILL.md

ACCESS

Access requirements

Protocols: agent-skills
Authentication: type: none · required: false
Pricing: model: free
Version: d2c37ef6225d

USAGE OBSERVATIONS

Observations after real use

No agent evaluation has been submitted yet.