api-architecture

Guide API architecture design across REST, gRPC, and GraphQL.

Updated Feb 15, 2026

Search Tags:#api design #openapi #rest #graphql #service mesh #api gateway #grpc

Ready to run

npx skills add https://github.com/Wbunker/skills-repo --skill api-architecture-wbunker

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: api-architecture
Source: https://github.com/Wbunker/skills-repo/tree/main/api-architecture
Command: npx skills add https://github.com/Wbunker/skills-repo --skill api-architecture-wbunker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides expert guidance on designing, operating, and evolving robust API-based systems, ensuring seamless communication and scalability.

Core Features & Use Cases

API Design: Covers REST, gRPC, GraphQL, OpenAPI specifications.
Traffic Management: Explains API gateways and service meshes.
Security & Operations: Details authentication, threat modeling, and deployment strategies.
Evolutionary Architecture: Guides on migrating monoliths and evolving API systems.
Use Case: You're designing a new microservices architecture and need to decide on the best API style (REST vs. gRPC vs. GraphQL) and how to secure and manage traffic between services.

Quick Start

Use the api-architecture skill to understand the differences between REST, gRPC, and GraphQL APIs.

Frequently Asked Questions about api-architecture

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

FAQPage Schema

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

REST, gRPC, and GraphQL differ in contract specifications, payload efficiency, and client autonomy. This skill explains these differences to help you select the optimal API style based on your resource modeling and traffic management needs.

How do I write an OpenAPI specification for a new REST API?▼

Writing an OpenAPI specification involves defining resource models, endpoints, and security schemes within a standardized contract. This skill details design principles for OpenAPI specifications to ensure seamless communication and scalability.

Do I need an API gateway or a service mesh for traffic management?▼

An API gateway manages external traffic and security, while a service mesh handles internal service-to-service communication. This skill details how to use both for comprehensive traffic management and zero-trust security in distributed systems.

How does zero-trust security apply to API authentication and threat modeling?▼

Zero-trust security in APIs requires strict authentication and continuous threat modeling to validate every request. This skill provides guidance on implementing these security considerations to protect API endpoints and ensure secure system communication.

When should I use gRPC instead of REST for microservices communication?▼

Use gRPC over REST for high-performance, low-latency inter-service communication, while REST suits public-facing APIs. This skill contrasts gRPC and REST to help you determine the best API style for your specific deployment patterns and performance requirements.

How do I handle API versioning and evolutionary architecture during monolith migration?▼

Handling API versioning during monolith migration requires evolutionary strategies that allow gradual modernization without breaking clients. This skill provides guidance on migrating monoliths and evolving API architectures effectively.