Good API design makes your code easy to use and hard to misuse. This guide helps you create stable, well-documented interfaces for REST APIs, GraphQL, module boundaries, and component props. Follow contract-first design, consistent error semantics, and validation at system edges to build reliable systems.
Anyone who builds public interfaces between code can benefit. Whether you work on backend endpoints, frontend components, or team contracts, these principles keep your work clear and predictable. Hyrum's Law reminds you that every observable behavior becomes a commitment, so be intentional about what you expose.
Use this approach when designing new APIs, changing existing ones, or defining boundaries between teams. The result is fewer surprises and happier users.
Global
mkdir -p ~/.claude/skills/api-and-interface-designProject
mkdir -p .claude/skills/api-and-interface-designSource Repository
Lark Openapi Explorerlarksuite/cli
Discover and call native Lark OpenAPIs not covered by existing CLI commands
Supabasesupabase/agent-skills
Add a database auth and APIs to your app with Supabase
Convex Quickstartget-convex/agent-skills
Rapidly set up a Convex backend for new or existing apps with one command
Convex Create Componentget-convex/agent-skills
Create reusable Convex components with isolated tables and clear APIs
Design An Interfacemattpocock/skills
Generate many different interface designs and pick the best one
Notion Apiintellectronica/agent-skills
Automate your Notion workspace with simple API calls
Convexget-convex/agent-skills
Use this router to find the perfect Convex skill for your task
Firecrawl Build Scrapefirecrawl/skills
Extract clean web content from a single URL quickly and reliably