api-forge

What problem does it solve?

This Skill solves the problem of designing consistent, reliable HTTP APIs by turning product requirements into a complete API contract with predictable behavior for errors, pagination, rate limiting, webhooks, and idempotency.

Core Features & Use Cases

• OpenAPI 3.1-first API design: Generate an OpenAPI 3.1 spec with endpoint summaries, parameters, request bodies, and fully enumerated responses.
• Production-grade HTTP semantics: Enforce correct method usage, consistent status code-to-code mappings, and envelope-style responses that include request correlation.
• Real-world operational concerns: Add cursor-based pagination, token-bucket rate limiting, webhook retry + HMAC signature verification, and idempotency for create/update actions (Stripe-style patterns).

Example use case: you need an API for an orders system with secure endpoints, cursor pagination for public listing, webhook notifications for order.created, and safe POST behavior using Idempotency-Key.

Quick Start

Ask the AI to design a REST API with cursor pagination, standardized error envelopes, rate limiting headers, webhook delivery with HMAC-SHA256 verification, and Idempotency-Key support for POST create endpoints.