Api Designer Pro

Expert API architect to design, review, and audit REST, GraphQL, and event-driven API specifications.

Install
cmdop skills install agensi-api-designer-pro

API Designer Pro is a skill published by agensi that functions as a virtual API architect for designing, reviewing, and auditing APIs across three paradigms: RESTful resources, GraphQL types and resolvers, and asynchronous event-driven systems.

When given high-level feature requirements, it produces detailed API specifications covering endpoints, schemas, and entity relationships. For existing designs, it performs design audits that surface issues such as improper resource naming, incorrect HTTP verb usage, and missing idempotency guarantees. Rather than producing generic CRUD-oriented output, it applies architectural principles like cursor-based pagination, resource-oriented URI structures, and correct HTTP status code semantics that reflect production realities.

For each design, it generates a tailored security checklist and error catalog, covering the specific risks and failure modes introduced by that particular design. The skill provides specialized templates and rule-sets depending on the paradigm—REST, GraphQL, or event-driven—so the output is structured and appropriate to the target architecture.

The resulting documentation is intended to be developer-ready, meaning it can be directly converted into an OpenAPI specification or used as the basis for code generation. This skill is suited to teams or individual developers who need rigorous, opinionated API design guidance embedded in an agent workflow rather than ad-hoc prompting.

Use cases

  • Convert a set of feature requirements into a full REST API specification with endpoints, HTTP verbs, and schemas
  • Audit an existing API design for naming conventions, verb misuse, and missing idempotency
  • Generate a GraphQL schema with types and resolvers from a data model description
  • Design an event-driven API with async message schemas and flow patterns
  • Produce a security checklist and error catalog tailored to a specific API design
  • Generate documentation structured for direct conversion into an OpenAPI spec

When to use it

  • Designing a new REST, GraphQL, or event-driven API from scratch and needing structured, opinionated output
  • Reviewing an existing API design for architectural problems before development begins
  • Needing pagination, versioning, and status code guidance enforced in the output
  • Embedding API design review into an agent or automated workflow

When not to use it

  • Generating runnable code or server stubs directly — this skill produces specifications, not implementation
  • If the target API style is not REST, GraphQL, or event-driven (e.g. XML-RPC, SOAP)
  • If automated testing or contract validation of a live API is required
  • If the goal is to interact with an existing API rather than design a new one