API Design

Provides API design guidelines for REST, GraphQL, versioning, logging, observability, and architecture patterns. Use when designing APIs, reviewing architecture, implementing microservices, or setting up monitoring.

diegosouzapw Updated 54 repo stars

File contents

API Design Skill

When to Use

  • Designing REST or GraphQL APIs
  • Architecture and microservices design
  • Setting up logging and observability
  • Implementing rate limiting or authentication
  • Code review for API endpoints

Reference Documents (Import Syntax)

API Design

@./reference/api-design.md

Architecture

@./reference/architecture.md

Observability

@./reference/logging.md @./reference/observability.md

Core Principles

  1. RESTful conventions: Use proper HTTP methods and status codes
  2. SOLID principles: Apply design patterns appropriately
  3. Structured logging: Include context and correlation IDs
  4. Observability: Implement metrics, traces, and health checks

diegosouzapw/awesome-omni-skill/tree/main/skills/development/api-design-kcenon commit 7e5f9ee95b

Frequently asked questions

npx skillmds@latest add diegosouzapw/api-design-4