Skill

api-design-principles

Guides REST and GraphQL API design with principles for intuitive, scalable, maintainable APIs. Use for designing new APIs, refactoring, standards, reviews, and documentation.

GraphQL

REST API

api-development

npx claudepluginhub sickn33/antigravity-awesome-skills --plugin antigravity-awesome-skills

Popularity

Parent stars

37,902

Parent forks

6,202

Shared by

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/antigravity-awesome-skills:api-design-principles

User invocable

Model invocable

Inline context

Default effort

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

Supporting Files

assets/api-design-checklist.mdassets/rest-api-template.pyreferences/graphql-schema-design.mdreferences/rest-best-practices.mdresources/implementation-playbook.md

SKILL.md

46 lines · ~449 tokens

Similar Skills

api-design-principles

Provides structured guidance on REST and GraphQL API design, including resource modeling, versioning strategies, and pagination patterns. Use when designing or reviewing API specifications.

4 files

superpowers

api-design

Guides API design decisions including REST vs GraphQL, resource modeling, versioning, error contracts, pagination, and authentication patterns.

3 files4 tools

playbooks-virtuoso

api-design-principles

122

Guides REST and GraphQL API design principles including resource-oriented architecture, HTTP methods, schema-first development, versioning strategies, pagination, and filtering patterns. Use for new API design, spec reviews, refactoring, and team standards.

4 files

ccpp

Stats

LanguagePython

Parent stars37,902

Parent forks6,202

MaintenanceExcellent

Last CommitMay 16, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Stats

Actions

Help us improve

Share bugs, ideas, or general feedback.

API Design Principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

Use this skill when

Designing new REST or GraphQL APIs

Refactoring existing APIs for better usability

Establishing API design standards for your team

Reviewing API specifications before implementation

Migrating between API paradigms (REST to GraphQL, etc.)

Creating developer-friendly API documentation

Optimizing APIs for specific use cases (mobile, third-party integrations)

Do not use this skill when

You only need implementation guidance for a specific framework

You are doing infrastructure-only work without API contracts

You cannot change or version public interfaces

Instructions

Define consumers, use cases, and constraints.

Choose API style and model resources or types.

Specify errors, versioning, pagination, and auth strategy.

Validate with examples and review for consistency.

Refer to resources/implementation-playbook.md for detailed patterns, checklists, and templates.

Resources

resources/implementation-playbook.md for detailed patterns, checklists, and templates.

Limitations

Use this skill only when the task clearly matches the scope described above.

Do not treat the output as a substitute for environment-specific validation, testing, or expert review.

Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.