api-patterns

Selects optimal API design approach from REST, GraphQL, or tRPC.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/uesleinasch/unac-agents --skill api-patterns-uesleinasch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-patterns
Source: https://github.com/uesleinasch/unac-agents/tree/main/skills-shared/api-patterns
Command: npx skills add https://github.com/uesleinasch/unac-agents --skill api-patterns-uesleinasch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

API design guidance and decision-making to help teams choose the right API style (REST, GraphQL, or tRPC) and establish best practices for versioning, responses, and security.

Core Features & Use Cases

  • Comprehensive decision framework to select REST, GraphQL, or tRPC based on project context
  • Guidelines, anti-patterns, and readouts for versioning, response formats, and authentication
  • Includes a validation script (scripts/api_validator.py) to assess API definitions for best practices

Quick Start

Ask me to help design an API by selecting an API style and outlining governance for versioning, responses, and security.

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 backend API design?

Choosing between REST, GraphQL, and tRPC for API design requires evaluating your project context, such as multi-platform frontend needs or evolving systems, against a decision framework to select the optimal style and associated practices.

What are common API design anti-patterns for versioning and response formats?

Common API design anti-patterns involve poor versioning strategies and inconsistent response formats, which you can identify and avoid by applying established guidelines and validation scripts that assess API definitions against best practices.

Can I validate my existing API definitions against security and versioning best practices?

You can validate existing API definitions against best practices by running a dedicated validation script that assesses your code and specifications for proper versioning, response formats, and security considerations.

When should I use GraphQL instead of REST for evolving backend services?

You should use GraphQL instead of REST for evolving backend services when your project requires flexible data fetching for multi-platform frontends, as determined by applying a comprehensive API design decision tree to your specific context.

What's the best way to establish API governance for authentication and versioning?

Establishing API governance for authentication and versioning is best achieved by applying a comprehensive design framework that outlines clear guidelines, anti-patterns, and security considerations tailored to your chosen API style.

Does tRPC work well for multi-platform frontend architectures?

tRPC works well for multi-platform frontends when your project context aligns with its type-safe data fetching capabilities, a fit determined by evaluating your architecture through an API style decision tree.