api-design-expert
API Design Expert provides comprehensive guidance on building scalable APIs using REST, GraphQL, and other modern patterns. Learn resource-oriented design, stateless architecture, versioning strategies, and critical practices like authentication, rate limiting, and structured error handling to ensure your APIs are secure, maintainable, and performant.
API Design Expert teaches REST architecture, GraphQL, versioning strategies, and API best practices for building robust services.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-03-30
API Design Expert teaches REST architecture, GraphQL, versioning strategies, and API best practices for building robust services. API Design Expert provides comprehensive guidance on building scalable APIs using REST, GraphQL, and other modern patterns. Learn resource-oriented design, stateless architecture, versioning strategies, and critical practices like authentication, rate limiting, and structured error handling to ensure your APIs are secure, maintainable, and performant.
Use it when
- API Design Expert outlines core RESTful principles including client-server separation, statelessness, uniform interfaces.
- API Design Expert covers multiple API versioning strategies, including URL path versioning, header-based versioning.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
personamanagmentlayer/pcl/api-design-expert · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to design REST APIs that follow best practices?
API Design Expert teaches resource-oriented design principles for REST APIs, emphasizing stateless architecture, proper HTTP method usage, and meaningful URI structures. The skill covers designing endpoints that are intuitive, scalable, and maintainable, including practices like using nouns for resources, implementing pagination, and structuring responses consistently. You'll learn how to create APIs that are easy for developers to understand and integrate with.
What are the key RESTful API principles I should follow?
API Design Expert outlines core RESTful principles including client-server separation, statelessness, uniform interfaces, and resource-based design. The skill emphasizes using standard HTTP methods (GET, POST, PUT, DELETE) correctly, designing hierarchical resource paths, implementing proper status codes, and following HATEOAS patterns for discoverability. These principles ensure your APIs are predictable, scalable, and aligned with web standards.
How do I version my API and maintain backward compatibility?
API Design Expert covers multiple API versioning strategies, including URL path versioning, header-based versioning, and query parameter approaches. The skill teaches backward compatibility techniques to prevent breaking existing client integrations when evolving your API. You'll learn when to version, how to deprecate endpoints gracefully, and strategies for managing multiple API versions simultaneously in production environments.
How should I implement API authentication and security?
API Design Expert provides guidance on securing APIs through authentication mechanisms like JWT token verification, OAuth 2.0, and API keys. The skill covers rate limiting implementation strategies to prevent abuse, input validation techniques, and HTTPS enforcement. You'll learn how to design security layers that protect your API while maintaining performance and usability for legitimate clients.
What error handling and response formats work best for APIs?
API Design Expert teaches structured error handling approaches, including consistent error response formats with meaningful status codes, error messages, and error codes. The skill emphasizes designing responses that help developers debug issues quickly while maintaining security by not exposing sensitive system details. You'll learn patterns for handling validation errors, authentication failures, and server-side exceptions gracefully.
How does GraphQL compare to REST for API design?
API Design Expert compares REST, GraphQL, gRPC, and WebSocket approaches, helping you choose the right style for your use case. GraphQL offers flexible querying and reduced over-fetching, while REST provides simplicity and HTTP caching benefits. The skill explores trade-offs in complexity, performance, caching strategies, and developer experience, enabling informed architectural decisions for your API platform.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
API Design Expert
Expert guidance for API design, RESTful principles, GraphQL, versioning strategies, and API best practices.
Core Concepts
API Design Principles
- RESTful architecture
- Resource-oriented design
- Uniform interface
- Statelessness
- Cacheability
- Layered system
API Styles
- REST (Representational State Transfer)
- GraphQL
- RPC (Remote Procedure Call)
- WebSocket
- Server-Sent Events (SSE)
- gRPC
Key Considerations
- Versioning strategies
- Authentication and authorization
- Rate limiting
- Error handling
- Documentation
- Backward compatibility
REST API Design
```python from fastapi import FastAPI, HTTPException, Query, Path, Header from pydantic import BaseModel, Field from typing import List, Optional from datetime import datetime from enum import Enum
app = FastAPI( title="User Management API", version="1.0.0", description="RESTful API for user
(truncated - see the full file via the links below)
File tree — 1 file
stdlib/api/api-design-expert/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Learn REST API design principles and best practices”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Master building high-performance Python APIs with FastAPI, covering async patterns, automatic data validation, dependency injection, and security. Learn routing, Pydantic models, and production-ready deployment strategies for modern backend services.
Learn to design and build RESTful APIs using proven patterns for resource modeling, HTTP semantics, and API architecture. This skill covers naming conventions, CRUD operations, versioning strategies, pagination, filtering, error handling, and hypermedia controls with FastAPI and Express.js examples.
Master microservice architecture using FastAPI, covering REST API design, asynchronous request handling, dependency injection patterns, and production deployment. Learn service communication strategies, API versioning, request validation, and best practices for scalable Python backends.
python-fastapi guides you through architecting enterprise-grade FastAPI applications with proven patterns for project layout, schema validation, dependency injection, and authentication. It covers async database integration with SQLAlchemy, JWT security, Docker containerization, and testing strategies to ensure your API runs reliably in production.
FastAPI Coder generates production-grade API endpoints using async/await, type-safe Pydantic models, and dependency injection. It structures projects with clear separation between routes, services, and repositories, plus patterns for authentication, testing, and database integration.
Python Backend Expert guides implementation of FastAPI endpoints, SQLAlchemy models, Pydantic schemas, and layered architecture with repositories and services. It covers async session management, dependency injection, error handling, and database migrations for Python 3.12+ projects.
More skills fastapi-patterns (MIT) · kotlin-expert (Apache-2.0) · ai-architect-expert (Apache-2.0) · typescript-expert (Apache-2.0) · Rest Api Expert (unlicensed) · construction-expert (Apache-2.0) · Api Design Skill (unlicensed) · dev-api-design (MIT)