koan-api-building
EntityController<T>, custom routes, payload transformers, auth policies
EntityController<T>, custom routes, payload transformers, auth policies
Build the AgentStack API Gateway in Go with Fiber/Chi. Use for creating REST API endpoints, HTTP handlers, middleware, request validation, and API routing. Triggers on "build API", "create endpoint", "HTTP handler", "REST API", "API gateway", "Fiber handler", "Chi router", or when implementing spec/004-api-design.md endpoints.
Guide for creating Pydantic v2 models with proper validation, field examples, and schema separation following this project's conventions.
This skill should be used when the user asks to "create MongoDB model", "define Beanie document", "write MongoDB query", "create aggregation pipeline", "run database migration", "index MongoDB collection", or mentions Beanie, Motor, MongoDB documents, or async database operations. Provides MongoDB/Beanie ODM patterns for FastAPI.
REST API design principles and patterns - use when designing new endpoints, creating DTOs, or planning API structure
Enterprise API design with REST, GraphQL, gRPC patterns including versioning, pagination, and error handling
Expert-level API design principles, REST, GraphQL, versioning, and API best practices
REST/GraphQL/gRPC API design best practices. Use when designing APIs, defining contracts, handling versioning. Covers OpenAPI 3.2, GraphQL Federation, gRPC streaming.
Expert-level FastAPI development for high-performance Python APIs with async support
Generate complete CRUD API endpoints with async patterns, Pydantic validation, JWT authentication, and proper error handling. Activates when creating new API resources or routes.
Implement input validation using class-validator decorators, custom validators, and business rule validation patterns. Use this skill when adding validation decorators to DTOs, creating validator service classes (*.validator.ts), implementing existence/uniqueness checks, or validating business rules in use cases. This includes using decorators like @IsNotEmptyString, @MaxLength, @IsArray, @IsString, creating custom decorators, and implementing fail-fast validation patterns in validator classes. Apply when working with DTO files, validator classes in shared/validator/, or implementing input sanitization.
Apply when validating external data (API inputs, form data, environment variables) with TypeScript type inference.
How to write Malli schemas for Guardrails function specifications in Clojure/ClojureScript. This skill teaches the schema types available, map schema patterns, and best practices for type-safe function definitions using >defn.
Generates new Go HTTP handlers following Ishkul patterns. Creates handler with proper request/response types, error handling, validation, structured logging, and matching test file. Use when adding new API endpoints.
Scaffolds a new FastAPI endpoint with Pydantic models, router registration, and tests. Use when creating new backend API endpoints. Related: pydantic-model-scaffolder for complex model validation.
Error handling with error classes, handlers, and interceptors. Use when handling API errors, displaying validation errors, configuring error handlers, or implementing error interceptors.
A comprehensive pattern for building type-safe forms and API validation using Zod, with automatic error formatting, runtime type checking, and seamless TypeScript integration. Use when building forms with client-side and server-side validation, validating API request/response payloads, creating reusable validation schemas, or ensuring data integrity across client and server.
Create Prisma model layer functions. Use when adding database operations. Never call Prisma directly in routes.
Use when working with JSON Schema for validation, including draft-07, 2019-09, and 2020-12 specifications
Add new API endpoints to the OpenGov SDK from an OpenAPI specification. Use when: (1) Adding a new resource module (e.g., fees.py, transactions.py) (2) Adding endpoints to an existing module (3) User provides an OpenAPI spec file path or asks to "add endpoints" or "implement API methods" Creates: endpoint module, Pydantic models (params, response, enums), tests, and exports.
Apply when validating API request inputs: body, query params, path params, and headers. This skill covers Zod v4 patterns.
Generate Django REST Framework serializers with validation, nested relationships, and best practices. Use when creating or updating API serializers, especially for complex models with relationships.
Fetch reference implementations from core-supabase repository. Use when (1) implementing Repository layer with Supabase, (2) need RPC function usage patterns, (3) checking correct parameter structures and type assertions, (4) verifying Supabase integration patterns.