Skill

api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing...

npx claudepluginhub absjaded/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

finishing-a-development-branch

174.6k

Verifies tests pass on completed feature branch, presents options to merge locally, create GitHub PR, keep as-is or discard; executes choice and cleans up worktree.

superpowers

systematic-debugging

174.6k

Guides root cause investigation for bugs, test failures, unexpected behavior, performance issues, and build failures before proposing fixes.

10 files

superpowers

writing-plans

174.6k

Writes implementation plans from specs for multi-step tasks, mapping files and breaking into TDD bite-sized steps before coding.

1 file

superpowers

Stats

Stars0

Forks0

Last CommitFeb 27, 2026

Used By3 plugins

Actions

View Source View Plugin View on GitHub View README

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.