Skip to main content
Back to registry

api-design-principles

wshobson/agents

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

Installs9
Install command
npx skills add https://github.com/wshobson/agents --skill api-design-principles
Security audits
Gen Agent Trust HubPASS
SocketPASS
SnykPASS
About 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. Resource-Oriented Architecture HTTP Methods Semantics: Schema-First Development Query Structure: URL Versioning: Header Versioning: Query Parameter Versioning: - 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) - Resources are nouns (users, orders, products), not verbs - Use HTTP methods for actions (GET, POST, PUT, PATCH, DELETE) - URLs represent resource hierarchies - Consistent naming conventions - GET : Retrieve resources (idempotent, safe) - POST : Create new resources - PUT : Replace entire resource (idempotent) - PATCH : Partial resource updates - DELETE : Remove resources (idempotent) - Types define your domain model - Queries for reading data - Mutations for modifying data - Subscriptions for real-time updates - Clients request exactly what they need - Single endpoint, multiple operations - Strongly typed schema - Introspection built-in - Consistent Naming : Use plural nouns for collections ( /users , not...

Source description provided by the upstream skill listing. Community reviews and install context appear in the sections below.

Community Reviews

Latest reviews

Sign in to review

No community reviews yet. Be the first to review.

Browse this skill in context
FAQ
What does api-design-principles do?

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

Is api-design-principles good?

api-design-principles does not have approved reviews yet, so SkillJury cannot publish a community verdict.

What agent does api-design-principles work with?

api-design-principles currently lists compatibility with Agent compatibility has not been published yet..

What are alternatives to api-design-principles?

Skills in the same category include telegram-bot-builder, flutter-app-size, sharp-edges, iterative-retrieval.

How do I install api-design-principles?

npx skills add https://github.com/wshobson/agents --skill api-design-principles

Related skills

More from wshobson/agents

Related skills

Alternatives in Software Engineering