Back to Agent Skills
Development & Testing
API and Interface Design
by Addy Osmani 78k GitHub stars
Contract-first API and boundary design with input validation and clear interface contracts.
#api#contracts#design#validation
Claude Code Codex
Overview
This skill applies a contract-first approach to designing APIs and module boundaries, emphasizing validated inputs and explicit interface contracts. It triggers when designing the shape of an API so integrations stay robust and predictable.
What it is good for
- Designing a new REST/RPC API
- Defining module boundary contracts
- Adding boundary input validation
- Reviewing an interface for robustness
Install
Install in Claude Code
# Add the marketplace, then install the skill in Claude Code:
/plugin marketplace add addyosmani/agent-skills
/plugin install api-and-interface-design
# Or install manually into ~/.claude/skills:
git clone https://github.com/addyosmani/agent-skills.git
cp -r agent-skills/api-and-interface-design ~/.claude/skills/api-and-interface-designExplore AI Tools
Discover the best AI tools that complement your skills
Read AI & Design Articles
Tips and trends in the world of design and AI
Related Skills
Development & Testing
MCP Builder
Guide the creation of Model Context Protocol servers to connect APIs and tools to AI agents.
Claude Code Codex
Development & Testing Superpowers
A core skills library of 20+ battle-tested, composable tools and workflows for everyday agent development tasks.
Claude Code Codex
Development & Testing Vercel React Best Practices
React and Next.js performance guidelines from Vercel Engineering — data fetching, bundle optimization, and rendering patterns.
Claude Code Codex