skills.rest
Wbunker
WbunkerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/Wbunker/skills-repo --skill api-architecture-wbunker
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
buiphucminhtambuiphucminhtam
47

solution-architect

Select architecture patterns and generate ADRs with scaffolded project structure.

Community
Advanced
ValyntValynt

zero-trust-service-mesh

Enforce mutual TLS and zero-trust policies across ValueOS agents in Kubernetes with Istio.

Official
Advanced
heaptracetechnologyheaptracetechnology
13

contract-test

Automate API contract testing with schema validation and OpenAPI checks.

Community
Advanced
iAmAdheiliAmAdheil

openapi-spec-generation

Generate and validate OpenAPI 3.1 specifications from codebases and design-first sources.

Community
Intermediate