Autonomous workflow for designing, specifying, implementing, testing, and documenting APIs end-to-end. Handles API design with REST or GraphQL patterns, OpenAPI/Swagger specification generation, endpoint implementation with validation and error handling, test generation, and API documentation.
- Phase 1: Design — Gather requirements, define resource model, choose REST vs GraphQL, confirm resource map
- Phase 2: Specification — Generate OpenAPI 3.x or GraphQL schema
- Phase 3: Implementation — Scaffold endpoints with validation, error handling, and middleware
- Phase 4: Testing — Unit and integration tests for every endpoint
- Phase 5: Documentation — Human-readable API docs from spec and code
api-design-principles— REST and GraphQL design patterns, status codes, paginationapi-design— OpenAPI templates and GraphQL schemaauth-patterns— Authentication and authorizationerror-handling— API error handling patternsrate-limiting— Rate limiting strategies- Command:
create-api-route— Single-endpoint scaffolding
- "build an API for [domain]"
- "create API for [resource]"
- "design API endpoints for [feature]"
- "generate OpenAPI spec for [service]"
- "add API endpoints for [module]"
- "API development for [project]"
From your project root:
mkdir -p .cursor/agents
cp -r ~/.ai-skills/agents/api .cursor/agents/apimkdir -p ~/.cursor/agents
cp -r ~/.ai-skills/agents/api ~/.cursor/agents/apiFrom your project root:
mkdir -p .claude/agents
cp -r ~/.ai-skills/agents/api .claude/agents/apimkdir -p ~/.claude/agents
cp -r ~/.ai-skills/agents/api ~/.claude/agents/apiFor best results, also install the skills this agent references (see Skills Used above).
Part of the Agents directory.