Can I use this to review existing API specifications?

Absolutely. It is designed to assist in auditing current API designs to ensure they follow industry standards, naming conventions, and security best practices.

How does it help with API performance?

It includes implementation patterns for efficient pagination and DataLoaders to prevent common performance bottlenecks like the N+1 problem in GraphQL.

Does it cover API versioning strategies?

Yes, it outlines multiple strategies including URL, Header, and Query Parameter versioning to help you manage long-term API maintenance and breaking changes.

Does this skill support both REST and GraphQL?

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

API Design Architect

Name: API Design Architect
Author: HermeticOrmus

byHermeticOrmus

0•

API Development

Architects robust REST and GraphQL interfaces using industry-standard patterns for scalability and developer experience.

The API Design Architect skill provides specialized guidance for building intuitive and maintainable APIs. It covers the full spectrum of modern backend design, from RESTful resource-oriented architecture and HTTP semantics to GraphQL schema-first development and N+1 query prevention. By implementing standardized patterns for pagination, error handling, and versioning, this skill ensures that your services are not only functional but also delight the developers who consume them. Whether you are bootstrapping a new microservice or refactoring a legacy system, this tool helps establish high-quality API standards across your codebase.

Key Features

01GraphQL schema-first development and Relay-style pagination

02Multi-strategy API versioning (URL, Header, and Query Param)

03Advanced implementation patterns like HATEOAS and DataLoaders

04Standardized error handling and HTTP status code mapping

05RESTful resource-oriented design and HTTP method semantics

060 GitHub stars

Use Cases

01Migrating existing REST services to a strongly-typed GraphQL schema

02Designing a new microservice API with consistent, scalable standards

03Refactoring legacy endpoints to improve developer experience and usability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hermeticormus/floraheritage api-design-principles

For use in Claude.ai and ChatGPT

Download Skill