Api Design

This is the skill you reach for when you need to turn a fuzzy service boundary or integration idea into an actual contract that implementation, testing, and docs can all work from. It walks you through choosing REST versus GraphQL with real reasons, modeling resources and operations, defining request/response shapes including the error cases people forget, and producing an OpenAPI spec or GraphQL SDL before anyone writes server code. The checklist explicitly separates contract design from writing tutorials or implementing auth middleware, and it hands off cleanly to other skills when the work shifts to documentation portals or backend testing. It assumes you have enough clarity to define a real interface, not that you're still figuring out what the feature should do.

Install to Claude Code

npx -y skills add akillness/oh-my-skills --skill api-design --agent claude-code