Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL
All skills

api-designer

Draft an OpenAPI 3.1 spec with resource model, endpoints, errors, and versioning plan.

When to use it

You have a domain model or feature list but no agreed API contract yet, and need endpoints, pagination, and error formats settled before coding.

For example

You say

Use the api-designer skill to design a REST API for a bookstore: books, authors, and orders, with cursor pagination and RFC 7807 errors. Produce an OpenAPI 3.1 spec.

You get
  • Resource model table
  • OpenAPI 3.1 YAML spec
  • Error response catalog

How it works

  • Sketches the resource model and relationships before writing any spec.
  • Includes a lint step with Redocly and a mock-server check with Prism to verify the contract.