Skill

api-design-principles

Provides REST and GraphQL API design principles for intuitive, scalable APIs. Useful for designing new APIs, refactoring, setting team standards, reviewing specs, migrations, and documentation.

GraphQL

REST API

api-development

npx claudepluginhub sickn33/antigravity-awesome-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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

Supporting Assets

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

SKILL.md

Similar Skills

api-design-principles

32.8k

Provides REST and GraphQL API design principles for intuitive, scalable APIs. Useful for designing new APIs, refactoring, setting team standards, reviewing specs, migrations, and documentation.

5 files

antigravity-awesome-skills

api-design-principles

682

Applies REST and GraphQL API design principles for intuitive, scalable APIs. Use when designing new APIs, reviewing specifications, refactoring, or establishing standards.

5 files

rmyndharis-antigravity-skills

api-design-principles

Provides REST and GraphQL API design principles including resource hierarchies, HTTP semantics, schema design, versioning, pagination, and filtering patterns for new APIs or reviews.

4 files

superpowers

Stats

Stars36383

Forks5961

Last CommitApr 13, 2026

Used By3 plugins

Actions

View Source View Plugin View on GitHub View README

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.