api-handbook
Installation
SKILL.md
Instructions
When to Use
- Use for REST-ish Route Handlers, status codes, errors, versioning.
- Prefer
forms-and-validationfor Server Action forms. - Prefer
webhook-receiversfor inbound provider callbacks.
Shape HTTP APIs implemented as Next.js Route Handlers (or edge/node runtime).
Decision: Handler vs Server Action vs webhook
| Need | Prefer |
|---|---|
| Browser form POST same-origin | forms-and-validation / Server Action |
| Public/partner HTTP JSON API | Route Handler (api-handbook) |
| Provider callback (Stripe/GitHub) | webhook-receivers |
| Long-lived stream | realtime-handbook |