Agent skill · software engineering · aj-geddes
fastapi-development
Build high-performance FastAPI applications with async routes, validation, dependency injection, security, and automatic API documentation. Use when developing modern Python APIs with async support, automatic OpenAPI documentation, and high performance requirements.
Why this skill is useful
Provides specific patterns and best practices for building FastAPI applications that the AI wouldn't reliably generate on its own.
What it needs
Requires fastapi, pydantic, sqlalchemy installed locally. About 2k tokens when loaded. Last updated 2026-03-04. 307 stars on the source repository.
What this skill does
FastAPI Development Table of Contents Overview When to Use Quick Start Reference Guides Best Practices Overview Create fast, modern Python APIs using FastAPI with async/await support, automatic API documentation, type validation using Pydantic, dependency injection, JWT authentication, and SQLAlchemy ORM integration. When to Use Building high-performance Python REST APIs Creating async API endpoints Implementing automatic OpenAPI/Swagger documentation Leveraging Python type hints for validation Building microservices with async support Integrating Pydantic for data validation Quick Start Minimal working example: Reference Guides Detailed implementations in the references/ directory: Guide Contents --- --- FastAPI Application Setup FastAPI Application Setup Pydantic Models for Validation Pydantic Models for Validation Async Database Models and Queries Async Database Models and Queries Security and JWT Authentication Security and JWT Authentication Service Layer for Business Logic Service Layer for Business Logic API Routes with Async Endpoints API Routes with Async Endpoints Best Practices ✅ DO Use async/await for I/O operations Leverage Pydantic for validation Use dependency injection for services Implement proper error handling with HTTPException Use type hints for automatic OpenAPI documentation Create service layers for business logic Implement authentication on protected routes Use environment variables for configuration Return appropriate HTTP status codes Document endpoints with docstrings and tags ❌ DON'T Use synchronous database operations Trust user input without validation Store secrets in code Ignore type hints Return database models in responses Implement authentication in route handlers Use mutable default arguments Forget to validate query parameters Expose stack traces in production
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aj-geddes/fastapi-development