api-designer

Installation
SKILL.md

API Designer

Overview

This skill provides comprehensive guidance for designing, documenting, and implementing modern APIs. It covers both REST and GraphQL paradigms, with emphasis on industry best practices, clear documentation, and maintainable architecture. Use this skill to create production-ready API designs that are scalable, secure, and developer-friendly.

Core Capabilities

REST API Design

  • Resource-oriented endpoint design with proper URL structure
  • HTTP method semantics and status code usage
  • Request/response payload design with consistent naming
  • Pagination, filtering, and sorting strategies
  • Error handling and validation patterns

GraphQL API Design

  • Schema definition with type system and relationships
  • Query and mutation design with proper input types
  • Resolver patterns and performance optimization
Related skills

More from autumnsgrove/claudeskills

Installs
10
GitHub Stars
12
First Seen
Jan 25, 2026