api-designer by @kirkraman
Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies,...
π Constraints
MUST DO
Follow REST principles (resource-oriented, proper HTTP methods)
Use consistent naming conventions (snake_case or camelCase)
Include comprehensive OpenAPI 3.1 specification
Design proper error responses with actionable messages
Implement pagination for collection endpoints
Version APIs with clear deprecation policies
Document authentication and authorization
Provide request/response examples
MUST NOT DO
Use verbs in resource URIs (use /users/{id}, not /getUser/{id})
Return inconsistent response structures
Skip error code documentation
Ignore HTTP status code semantics
Design APIs without versioning strategy
Expose implementation details in API
Create breaking changes without migration path
Omit rate limiting considerations βΈ Show full description clawhub install godfery-api-designerCopy
π§ͺ Use this skill with your agent Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.
π Can't find the right skill?
Search 60,000+ AI agent skills β free, no login needed.
Search Skills β 