backend-python
FastAPI Python backend in api/. Covers routes, models, Supabase integration, authentication, R2 storage, and Cloudflare Workers deployment. Port 9999 for local dev. OpenAPI docs at /docs.
When & Why to Use This Skill
This Claude skill provides a comprehensive development toolkit for building and maintaining a FastAPI-based Python backend. It streamlines the entire API lifecycle, from defining Pydantic models and routing logic to integrating Supabase databases, implementing JWT authentication, and managing Cloudflare R2 storage. Designed for modern cloud-native development, it also includes specific workflows for Cloudflare Workers deployment and local environment configuration.
Use Cases
- Rapid API Prototyping: Quickly generate boilerplate code for new FastAPI endpoints, including request validation and response schemas.
- Database Management: Seamlessly integrate Supabase for database operations, including RLS-aware queries and data persistence.
- Security & Auth Implementation: Add robust authentication layers to your backend using pre-defined workflows for JWT validation and user session management.
- Cloud Storage Integration: Automate file handling tasks such as uploading, reading, and listing objects within Cloudflare R2 buckets.
- DevOps & Deployment: Streamline the transition from local development (port 9999) to production deployment on Cloudflare Workers with guided configuration.
| name | backend-python |
|---|---|
| description | FastAPI Python backend in api/. Covers routes, models, Supabase integration, authentication, R2 storage, and Cloudflare Workers deployment. Port 9999 for local dev. OpenAPI docs at /docs. |
Skill: Backend Python
Comprehensive backend development support for the Python/FastAPI API.
Routing Logic
Analyze the user's intent and route to the appropriate workflow:
Route Development → workflows/create-route.md
- "Create an endpoint for [feature]"
- "Add a [method] route for [resource]"
- "Implement the [endpoint_name] API"
Model Development → workflows/create-model.md
- "Create a model for [entity]"
- "Add Pydantic schema for [data]"
- "Define types for [feature]"
Database Operations → workflows/database.md
- "Query [table] from Supabase"
- "Insert data into [table]"
- "Add RLS-aware database call"
Authentication → workflows/auth.md
- "Protect this endpoint"
- "Get current user"
- "Validate JWT token"
R2 Storage → workflows/r2-storage.md
- "Upload file to R2"
- "Read from storage bucket"
- "List objects in R2"
Configuration Questions → context/config.md
- "What port is the backend on?"
- "How do I start the dev server?"
- "Where are environment variables?"
Workflows
workflows/create-route.md- Create new API endpointsworkflows/create-model.md- Define Pydantic modelsworkflows/database.md- Supabase database operationsworkflows/auth.md- Authentication and authorizationworkflows/r2-storage.md- R2 object storage operations
Context
context/config.md- Project configurationcontext/structure.md- Directory structurecontext/patterns.md- Common patterns