api-design

Audit REST and real-time API endpoints for N+1, idempotency, and pagination risks.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/luyzkk/Anti-Vibe-Coding --skill api-design-luyzkk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/luyzkk/Anti-Vibe-Coding/tree/main/skills/api-design
Command: npx skills add https://github.com/luyzkk/Anti-Vibe-Coding --skill api-design-luyzkk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you design and audit APIs so they avoid common production failures like N+1 performance traps, non-idempotent write behaviors, insecure webhook handling, and inefficient pagination or protocol choices.

Core Features & Use Cases

  • API design consultation (no code generation): Explains patterns, tradeoffs, and anti-patterns for endpoint and protocol decisions.
  • Endpoint auditing & decision trees: Guides you through choosing strategies for N+1 prevention, idempotency, pagination, concurrency, and protocol selection.
  • Safety-focused guidance: Emphasizes correctness for webhooks, status codes, GraphQL depth limits, and DTO boundaries to reduce security and reliability risks.

Quick Start

Ask the Skill to audit your endpoint and explain what to change so it is idempotent, paginated correctly, and avoids N+1 issues: "Analyze this API endpoint design for correctness, performance risks (N+1), idempotency, and pagination strategy: <paste endpoint description or spec here>."

Frequently Asked Questions about api-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my API design for N+1 performance issues and idempotency risks?

You can audit your API endpoint by analyzing its behavior for N+1 performance issues, idempotency risks, and pagination strategy using decision trees and checklists that recommend safer, production-grade patterns without generating code.

What is the best way to choose between REST, GraphQL, Webhooks, and gRPC for my API?

Choosing between REST, GraphQL, Webhooks, WebSockets, SSE, AMQP, and gRPC requires evaluating your protocol selection needs against endpoint safety, real-time behavior, and specific query depth limits to determine the correct architectural fit.

How does idempotency work in API design and when do I need it for write operations?

Idempotency in API design ensures that repeated write operations produce the same result without duplicate side effects, which is essential for handling concurrency risks and securing webhook payloads in production endpoints.

Can I use this API design consultation to evaluate pagination and status code correctness?

You can use this API design consultation to evaluate pagination strategies and status code correctness by reviewing your DTO boundaries and endpoint specifications to identify anti-patterns and improve reliability.

When should I not use GraphQL over REST for endpoint design?

You should reconsider using GraphQL over REST when your endpoints face depth limit risks or complex concurrency issues, as evaluating protocol selection tradeoffs helps determine if REST provides safer boundaries for your specific use case.