Is the guidance framework-specific?

While the core principles are language-agnostic, the skill provides practical implementation examples using popular frameworks like FastAPI for REST and Ariadne for GraphQL.

Can it help with GraphQL performance optimization?

Yes, the skill includes specialized patterns for implementing DataLoaders to solve the N+1 problem and optimize batch data fetching.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive patterns and best practices for both architectural styles, including resource-oriented REST design and schema-first GraphQL development.

How does this skill handle API versioning?

It includes specific implementation patterns for URL-based, header-based, and query parameter-based versioning to ensure backward compatibility.

API Design Principles

Name: API Design Principles
Author: Krosebrook

byKrosebrook

•

API Development

Implements industry-standard REST and GraphQL architectural patterns to build scalable, maintainable, and developer-friendly backend services.

The API Design Principles skill empowers Claude with specialized knowledge for architecting robust communication layers in modern applications. It provides structured guidance on resource-oriented RESTful design, schema-first GraphQL development, and essential cross-cutting concerns like versioning and error handling. By utilizing this skill, developers can ensure their APIs follow consistent naming conventions, implement efficient pagination, prevent N+1 query problems using DataLoaders, and maintain high usability standards for third-party integrations and internal frontends alike.

Key Features

01Standardized RESTful resource modeling and HTTP method semantics

02Performance optimization patterns including HATEOAS and DataLoaders

03Multiple API versioning strategies for long-term maintenance

041 GitHub stars

05GraphQL schema-first design with Relay-style pagination patterns

06Comprehensive error handling and status code mapping

Use Cases

01Architecting a new microservice API from initial specification to implementation

02Establishing organizational API design guidelines for multi-team consistency

03Refactoring legacy endpoints to align with modern RESTful or GraphQL standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add krosebrook/source-of-truth-monorepo api-design-principles

For use in Claude.ai and ChatGPT

Download Skill