api-patterns

Guide API design decisions between REST, GraphQL, and tRPC.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/gonzoblasco/antigravity-developer-stack --skill api-patterns-gonzoblasco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-patterns
Source: https://github.com/gonzoblasco/antigravity-developer-stack/tree/main/backend-infra/api-patterns
Command: npx skills add https://github.com/gonzoblasco/antigravity-developer-stack --skill api-patterns-gonzoblasco

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps API teams standardize design decisions across REST, GraphQL, and tRPC, ensuring consistent responses, versioning, and rate-limiting.

Core Features & Use Cases

  • Decision framework for choosing API styles (REST, GraphQL, tRPC) based on consumer needs and complexity.
  • Reference-driven guidance with a mapped content map to dive into best practices (REST, GraphQL, authentication, versioning, rate limiting, etc).
  • Quick Start example showing how to initiate API-patterns design in a real project.

Quick Start

Use the skill to align API design decisions in your project: start with defining your API consumers, choose an API style, and consult the references for deeper rules.

Frequently Asked Questions about api-patterns

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

FAQPage Schema
How do I choose between REST, GraphQL, and tRPC for my API design?

Choosing between REST, GraphQL, and tRPC requires evaluating your API consumers and project complexity. This framework maps consumer requirements to the most suitable API style, ensuring scalable and consistent service exposure for public APIs and TS monorepos.

What are the best practices for API versioning and rate-limiting?

Best practices for API versioning and rate-limiting involve applying standardized response formats and access controls. This guidance uses internal references and concrete examples to enforce consistency across public APIs and internal services without requiring external tooling.

Can I use this API design framework for TypeScript monorepos?

Yes, you can use this framework for TypeScript monorepos. It specifically applies to TS monorepos, public APIs, and internal services, guiding decisions on tRPC integration alongside REST and GraphQL to enforce consistency across your stack.

Do I need external tooling to enforce OpenAPI consistency?

No, you do not need external tooling to enforce OpenAPI consistency. The framework relies entirely on internal references and concrete examples to guide API design decisions, standardize response formats, and enforce rate-limiting rules.

How do I start standardizing API responses across multiple services?

To start standardizing API responses, define your API consumers, choose an API style like REST or GraphQL, and consult the provided references. This quick start approach aligns design decisions for consistent responses, versioning, and rate-limiting.