api-patterns

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

10|2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/bugrabilge/bilge-development-kit --skill api-patterns-bugrabilge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-patterns
Source: https://github.com/bugrabilge/bilge-development-kit/tree/main/skills/api-patterns
Command: npx skills add https://github.com/bugrabilge/bilge-development-kit --skill api-patterns-bugrabilge

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps developers make informed decisions about API design, ensuring they choose the right architecture (REST, GraphQL, tRPC) and implement best practices for security, versioning, and response formats.

Core Features & Use Cases

  • Architecture Selection: Guides the choice between REST, GraphQL, and tRPC based on project needs.
  • Best Practices: Covers naming conventions, HTTP methods, status codes, authentication, rate limiting, and pagination.
  • Use Case: A team is starting a new project with a TypeScript monorepo and needs to decide on the best API approach. This Skill provides a clear decision tree and comparison to help them select tRPC for type safety and efficiency.

Quick Start

Use the api-patterns skill to decide whether to use REST, GraphQL, or tRPC for a new project.

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 a new API?

Choosing between REST, GraphQL, and tRPC depends on your project needs like type safety and data fetching efficiency. This Skill provides a decision tree and comparison to guide your architecture selection for robust, scalable APIs.

What are the best practices for API pagination and versioning?

API best practices for pagination and versioning involve implementing standard naming conventions and HTTP methods to manage data load and maintain backward compatibility. This Skill covers these essential aspects to ensure your API responses are structured and reliable.

Does tRPC work well for TypeScript monorepo API design?

tRPC works exceptionally well for TypeScript monorepo API design by providing end-to-end type safety and efficiency. This Skill helps you evaluate if tRPC is the right fit compared to REST and GraphQL for your specific architecture.

How do I implement authentication and rate limiting in API design?

Implementing authentication and rate limiting in API design requires applying specific security protocols and request thresholds to protect endpoints. This Skill provides guidance on these best practices along with security testing for your API.

When should I not use GraphQL for my API architecture?

You should not use GraphQL when your project requires simple data retrieval without complex querying or when facing bandwidth constraints. This Skill helps identify these constraints by comparing GraphQL against REST and tRPC alternatives.