backend-api
Design and implement RESTful APIs, GraphQL endpoints, and backend API architecture following modern standards. Use this skill when creating or modifying API endpoints, route handlers, controllers, API middleware, authentication/authorization logic, or any files that define HTTP endpoints such as routes.py, api.js, controllers/, endpoints/, or API specification files (OpenAPI/Swagger). Apply this skill when implementing API versioning, rate limiting, request/response handling, API documentation, or when working with API gateway configurations. This skill is essential for building scalable, secure, and well-documented APIs that follow RESTful principles, handle errors gracefully, and provide consistent developer experiences across microservices and serverless architectures.
When & Why to Use This Skill
This Claude skill provides comprehensive guidance for designing and implementing modern backend API architectures, including RESTful and GraphQL endpoints. It streamlines the development of secure, scalable, and well-documented services by automating the creation of route handlers, middleware, and authentication logic while ensuring compliance with industry standards like OpenAPI and Swagger.
Use Cases
- Developing RESTful and GraphQL Endpoints: Efficiently create or modify controllers, resolvers, and route handlers using modern coding standards.
- Implementing Security and Middleware: Build robust authentication, authorization, and rate-limiting logic to protect backend infrastructure.
- API Documentation and Specification: Generate and maintain accurate OpenAPI/Swagger files to ensure a consistent developer experience and clear documentation.
- Lifecycle and Versioning Management: Apply URL or header-based versioning strategies and implement graceful error handling for production-ready APIs.
- Advanced Data Operations: Integrate pagination, filtering, sorting, and search capabilities into existing API endpoints to handle complex data queries.
| name | Backend API |
|---|---|
| description | Design and implement RESTful APIs, GraphQL endpoints, and backend API architecture following modern standards. Use this skill when creating or modifying API endpoints, route handlers, controllers, API middleware, authentication/authorization logic, or any files that define HTTP endpoints such as routes.py, api.js, controllers/, endpoints/, or API specification files (OpenAPI/Swagger). Apply this skill when implementing API versioning, rate limiting, request/response handling, API documentation, or when working with API gateway configurations. This skill is essential for building scalable, secure, and well-documented APIs that follow RESTful principles, handle errors gracefully, and provide consistent developer experiences across microservices and serverless architectures. |
Backend API
This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle backend API.
When to use this skill
- When creating or modifying REST API endpoints, routes, or controllers
- When implementing GraphQL schemas, resolvers, or queries
- When working on API middleware, authentication, or authorization logic
- When designing API request/response structures and data serialization
- When implementing API versioning strategies (URL path or header-based)
- When adding rate limiting, throttling, or API security features
- When writing API documentation (OpenAPI/Swagger specifications)
- When working with files like
routes.py,api.js,controllers/,endpoints/, or API gateway configs - When implementing error handling and consistent HTTP status codes for APIs
- When building microservices communication patterns or serverless API functions
- When adding pagination, filtering, sorting, or search capabilities to API endpoints
- When implementing async APIs, webhooks, or event-driven API patterns
Instructions
For details, refer to the information provided in this file: backend API