Skill

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.

npx claudepluginhub mit-network/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

using-superpowers

178.4k

Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.

3 files

superpowers

Stats

Stars1

Forks0

Last CommitMar 29, 2026

Used By2 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.