Agent skill · Backend & API

API Designer

Design REST and GraphQL APIs. Use when creating backend APIs, defining API contracts, or integrating third-party services. Covers endpoint design, authentication, versioning, documentation, and best practices.

majiayu000github.com/majiayu000GitHub ↗
claude-codeMIT
Install
npx skills add majiayu000/claude-skill-registry --skill api-designer-daffy0208-ai-dev-standards --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 12 KB
Bundled scripts: none
Version: 1.0.0
Path: skills/api/api-designer-daffy0208-ai-dev-standards/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 534
Language: HTML

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# API Designer Design robust, scalable, and developer-friendly APIs. ## Core Principles ### 1. Developer Experience First - Clear, predictable naming conventions - Comprehensive documentation - Helpful error messages - Consistent patterns across endpoints ### 2. Design for Evolution - Versioning strategy from day one - Backward compatibility - Deprecation process - Migration guides for breaking changes ### 3. Security by Default - Authentication and authorization - Rate limiting and throttling - Input validation and sanitization - HTTPS only, no exceptions ### 4. Performance Matters - Efficient queries and indexing - Caching strategies - Pagination for large datasets - Compression (gzip, brotli) ## REST API Design ### Resource Naming Conventions ``` ✅ Good (Nouns, plural, hierarchical): GET /users # List all users GET /users/123 # Get specific user POST /users # Create user PUT /users/123 # Replace user PATCH /users/123 # Update user DELETE /users/123 # Delete user GET /users/123/posts # User's posts (nested) GET /users/123/posts/456 # Specific post ❌ Bad (Verbs, inconsistent, unclear): GET /getUsers POST /createUser GET /user-list GET /UserData?id=123 ``` ### HTTP Methods & Semant

What's inside
Steps it walks through
  1. Core Principles
  2. 1. Developer Experience First
  3. 2. Design for Evolution
  4. 3. Security by Default
  5. 4. Performance Matters
  6. REST API Design
  7. Resource Naming Conventions
  8. HTTP Methods & Semantics
  9. HTTP Status Codes
  10. Response Format Standards
  11. Pagination Strategies
  12. Filtering, Sorting, and Search
  13. Authentication & Authorization
  14. Rate Limiting
Ships with 1 file
  • metadata.json
More from claude-skill-registry
All skills →
About this skill
What does the API Designer skill do?

Design REST and GraphQL APIs. Use when creating backend APIs, defining API contracts, or integrating third-party services. Covers endpoint design, authentication, versioning, documentation, and best practices.

How do I install it?

Run `npx skills add majiayu000/claude-skill-registry --skill api-designer-daffy0208-ai-dev-standards --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going