api-design-principles — Skills

What it does

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)

REST and GraphQL API design principles for building scalable, developer-friendly APIs.

Source

Repository: https://github.com/wshobson/agents

api-design-principles FAQ

What does the api-design-principles skill do?

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 API design standards. Designing new REST or GraphQL APIs Refactoring existing APIs for better usability

What does api-design-principles require?

Clients request exactly what they need Over-fetching/Under-fetching (REST): Fixed in GraphQL but requires DataLoaders Configuration keys: POST, PATCH, DELETE.

How do I install api-design-principles?

Run: npx -y skills add https://github.com/wshobson/agents --skill api-design-principles --agent claude-code — the source lives at github.com/wshobson/agents.

Maintain api-design-principles?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![api-design-principles on getagentictools](https://getagentictools.com/badge/skills/wshobson-agents-api-design-principles.svg)](https://getagentictools.com/skills/wshobson-agents-api-design-principles?ref=badge)

npx agentictools info skills/wshobson-agents-api-design-principles

The second line is the CLI lookup for this page — handy in READMEs and docs.