api-designer
REST/GraphQL API architect specializing in OpenAPI 3.1, HATEOAS, pagination, and versioning strategies
REST/GraphQL API architect specializing in OpenAPI 3.1, HATEOAS, pagination, and versioning strategies
REST and GraphQL API design patterns, best practices, and conventions. Use when designing APIs, discussing HTTP methods, status codes, versioning, or API documentation. Triggers on mentions of REST, API, GraphQL, endpoint, HTTP methods, OpenAPI, swagger, API versioning.
REST API design patterns for endpoints, responses, errors, and conventions
Teaches how to validate external data at runtime using Zod and other validation libraries in TypeScript. Use when working with APIs, JSON parsing, user input, or any external data source where runtime validation is needed.
API versioning strategies for Node.js backends. Use when implementing versioned APIs.
REST API design conventions and best practices. Use when designing endpoints, naming resources, choosing HTTP methods, structuring responses, handling errors, or planning API versioning.
Parses and validates a handoff artifact into canonical JSON.
Build async database integration into FastAPI applications using SQLModel and async SQLAlchemy. This skill should be used when users want to create async-first database layers with SQLModel models, async sessions, relationships (with joinedload/selectinload), migrations, and production-grade patterns. Covers model definition, async CRUD operations, relationship eager loading, connection pooling, and Alembic migrations with async support. Always fetches latest SQLModel and SQLAlchemy async documentation before implementation.
Automatically applies when creating data models for API responses and validation. Uses Pydantic BaseModel with validators, field definitions, and proper serialization.
This skill should be used when setting up a stateless MCP (Model Context Protocol) server in FastAPI using the Official MCP SDK with 5 task management tools that interact with SQLModel database.
Control API Platform output with serialization groups, custom normalizers, and context-aware serialization. WHEN: Configuring serialization groups, creating custom normalizers, implementing computed fields, role-based serialization, controlling API response shape. WHEN NOT: API security (use php-symfony-api-platform-security), filters (use php-symfony-api-platform-filters), resource configuration (use php-symfony-api-platform-resources).
Validates frontend-backend API contracts. Apply when modifying API endpoints or service files.
Designs comprehensive Zod schemas for MCP tool inputs and API responses, ensuring type safety, clear validation error messages, and security through input sanitization patterns.
Create Express.js API endpoint with controller, service, validation
Creates REST API endpoints following project conventions with proper HTTP methods, validation, error handling, Swagger documentation, and security
Design and implement RESTful API endpoints following REST principles with clear resource-based URLs and appropriate HTTP methods. Use this skill when creating or modifying API routes, endpoints, controllers, or API handlers. When working with HTTP request/response handling, API versioning, rate limiting, or status code management. When designing URL structures, query parameters, or nested resource endpoints. When implementing API middleware, authentication endpoints, or any server-side API logic in route files, controller files, or API configuration files.
Structure API responses with consistent envelopes, appropriate HTTP status codes, and standardized error formats. Use this skill when implementing response handlers, formatting API response data, creating error response structures, implementing validation error responses, setting up pagination response formats, defining response DTOs or serializers, implementing HTTP status code logic, creating response middleware or interceptors, formatting success and error response envelopes, sanitizing response data to prevent sensitive data leakage, implementing field-level validation error responses, or working with response transformation logic. Use when writing controller return statements, response serializers, error handlers, or any code that formats and returns data to API clients.
Optimize Zod validation performance with safeParse, bulk array validation, schema reuse, and passthrough patterns
Create Laravel Eloquent model with relationships, scopes, and casts
Implement a new feature using route-scoped modules, standardized API hooks (useFetch/usePost), and Zod-validated payloads.
Generates protobuf API definitions for go-kratos microservices with HTTP annotations, validation rules, and OpenAPI documentation. Use when defining service contracts and APIs.
バックエンドに新しいAPIエンドポイントを追加します。「APIエンドポイント追加」「新しいエンドポイント」「REST API作成」などのリクエストで使用します。
Standard patterns for building and maintaining CRUD APIs with FastAPI and SQLModel: models, routers, database access, and error handling in a reusable way.