api-patterns

Select REST, GraphQL, or tRPC and document API guidelines.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/lchenrique/politron-ide --skill api-patterns-lchenrique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-patterns
Source: https://github.com/lchenrique/politron-ide/tree/main/.agent/skills/api-patterns
Command: npx skills add https://github.com/lchenrique/politron-ide --skill api-patterns-lchenrique

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a structured approach to selecting API design patterns (REST, GraphQL, tRPC) and establishes consistent guidelines for responses, versioning, and pagination across projects.

Core Features & Use Cases

  • API style decision guidance based on project needs (consumers, data shape, caching, and evolve requirements)
  • Documentation standards for endpoints, schemas, errors, and security
  • Use cases include designing a public API, internal microservices, and TS monorepos with multi-platform frontends

Quick Start

Use the api-patterns skill to guide your API design decisions for a new microservice and generate a decision checklist.

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 depends on your consumers, data shape, caching, and evolution needs. A decision checklist evaluating these factors helps establish the appropriate API style and consistent response formats.

What is the best way to establish consistent API versioning and pagination strategies?

Establishing consistent API versioning and pagination requires structured guidelines that document endpoints, schemas, and errors. Applying a decision checklist ensures repeatable patterns and scalable architecture across both small services and large multi-platform projects.

Can I use this API patterns approach for internal microservices and TypeScript monorepos?

Yes, this API patterns approach applies to internal microservices and TypeScript monorepos with multi-platform frontends. It enforces documentation standards for endpoints, schemas, errors, and security considerations across varying project scales.

How do I document API security considerations and error handling for a public API?

Documenting API security considerations and error handling requires a structured decision checklist. This enforces standards for documenting endpoints, schemas, and errors, ensuring clear API guidelines for public and internal services.

Why do I need a decision checklist for API architecture decisions?

A decision checklist for API architecture is needed to systematically evaluate consumers, style, versioning, and error handling. It ensures repeatable patterns and clear guidelines when selecting REST, GraphQL, or tRPC designs.