apis

What problem does it solve?

This Skill helps teams design consistent, discoverable, and backward-compatible APIs for SaaS products, reducing integration friction, preventing breaking changes, and improving developer experience across internal and external consumers.

Core Features & Use Cases

• API style guidance: Recommend REST, GraphQL, tRPC, or gRPC based on consumer needs and trade-offs.
• Design rules and patterns: URL structure, HTTP methods, idempotency, pagination strategies, filtering, and sparse fieldsets.
• Reliability & security: Authentication models, API key conventions, rate limiting, error formats, and webhook best practices.
• Documentation & SDKs: OpenAPI-first approach, quickstart examples, changelogs, and SDK generation for multiple languages.
• Use Case: Create a public REST API with versioning, OpenAPI docs, rate limits, and webhook event delivery for a multi-tenant project management SaaS.

Quick Start

Design a v1 REST API for a project management SaaS with resources users, teams, and projects, include cursor pagination, OpenAPI documentation, and API key authentication.