Skill backend-fastapi-python
✓ VerificadoDesarrolla backends en Python utilizando FastAPI, SQLModel y SQLAlchemy asíncrono con patrones específicos para servicios, autenticación y manejo de errores.
- Estrellas en GitHub
- 126
- Archivos
- 12
- Último commit
- 16 may 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill backend-fastapi-python?
Desarrolla backends en Python utilizando FastAPI, SQLModel y SQLAlchemy asíncrono con patrones específicos para servicios, autenticación y manejo de errores.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill backend-fastapi-python
La función principal de este SKILL es la construcción de backends en Python utilizando FastAPI, SQLModel y SQLAlchemy asíncrono. Los desarrolladores lo utilizan para construir endpoints de API, escribir funciones de servicio sin estado y definir esquemas de Pydantic o SQLModel. Está diseñado específicamente para tareas de arquitectura de backend, incluyendo la configuración de cadenas de dependencias de autenticación como get_current_user e is_superuser, la gestión de sesiones asíncronas de SQLAlchemy y el manejo de migraciones con Alembic.
Un agente debe cargar este SKILL siempre que una tarea involucre código de API en Python, diseño de request/response o patrones de backend dentro de este código base. Proporciona orientación sobre convenciones específicas del proyecto, como el uso del wrapper ApiResponse[T] y la implementación de AppException para códigos de error. El SKILL ayuda a navegar restricciones técnicas como evitar consultas N+1 con selectinload, gestionar tareas en segundo plano y asegurar el uso correcto de validadores de Pydantic V2. No cubre desarrollo frontend, Docker, CI/CD ni infraestructura general.
Lo que un agente puede hacer con ella
- 1Implementar endpoints de API segurosCrea rutas de FastAPI que utilicen inyección de dependencias para el control de acceso basado en roles.
- 2Gestionar esquemas de base de datos y migracionesDefine modelos ORM y ejecuta migraciones de Alembic para actualizar la estructura de la base de datos.
- 3Desarrollar capas de servicio sin estadoEscribe funciones de servicio que interactúen con la base de datos utilizando una sesión asíncrona.
- 4Depurar problemas en las respuestas de la APISoluciona problemas sobre por qué faltan ciertos campos en las respuestas de la API o por qué ocurren errores 422.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill backend-fastapi-python
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill backend-fastapi-python en Claude Code
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonInstalar la skill backend-fastapi-python en Claude Code (project)
.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python .claude/skills/backend-fastapi-pythonInstalar la skill backend-fastapi-python en Codex
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonInstalar la skill backend-fastapi-python en Gemini CLI
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonInstalar la skill backend-fastapi-python en Claude.ai
npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python backend-fastapi-python && zip -r backend-fastapi-python.zip backend-fastapi-python # claude.ai → Customize → Skills → + → Create skill → Upload a skill → backend-fastapi-python.zip
Verificaciones automáticas
Ejecutado 16 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleavibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Aprobado
SKILL.md
Ver en GitHubBackend FastAPI Python
Project-specific conventions for FastAPI with SQLModel, pydantic-settings, and async SQLAlchemy.
Architecture Decisions
- Services are stateless functions — Not classes. First param is
db: AsyncSession. - Generic response wrapper — Always use
ApiResponse[T]for consistency. - Dependencies chain —
get_current_user->require_auth->require_admin. - Module-scoped config — Each module can have its own
{module}_config.py. - Error codes for frontend —
AppException(status, message, error_code).
Gotchas
- SQLModel
Relationship()fields are NOT included in API responses by default. You must explicitly add them tomodel_configor use a separate response schema with those fields. AsyncSession.refresh()does not load relationships. After commit, re-query with.options(selectinload(...))if you need related objects.- Pydantic V2 uses
model_validatornotvalidator. The@validatordecorator is V1 and will break silently or raise deprecation warnings. Depends()in FastAPI creates a NEW instance per request — don't store state in dependency return values expecting it to persist.- Background tasks (
BackgroundTasks) run AFTER the response is sent. If they fail, the client already got a 200. Use proper task queues (Celery, ARQ) for anything that must not silently fail. - Alembic
--autogeneratemisses: table renames (generates drop+create), index changes on existing columns, andEnumtype modifications in PostgreSQL. Always review generated migrations. async defendpoints block the event loop if you call sync I/O inside them. Userun_in_executorfor sync libraries or define the endpoint asdef(FastAPI runs sync endpoints in a threadpool).HTTPExceptionfrom FastAPI andHTTPExceptionfrom Starlette are different classes. Importing the wrong one causes middleware to miss exception handlers.- SQLAlchemy's
lazy="selectin"on relationships causes N+1 queries in async sessions. Use explicitselectinload()in queries instead. Optional[str] = Nonein query params makes the field optional.str = Nonealso works but loses type information — prefer the explicitOptionalform.- When using
response_model, FastAPI filters OUT any fields not in the model. If your response is missing data, check that the response model includes all fields, not just the ORM model.
References
| When you need... | Read |
|---|---|
| Directory layout | file-structure.md |
| Settings and env vars | configuration.md |
| Database sessions and connections | database.md |
| ORM models | models.md |
| Request/response schemas | schemas.md |
| Router and endpoint patterns | routing.md |
| Service layer patterns | services.md |
| Dependency injection | dependencies.md |
| Middleware setup | middleware.md |
| Error handling | error-handling.md |
| Auth flow example | auth.md |
Archivos de esta skill
12Preguntas sobre la skill backend-fastapi-python
¿Cómo instalo la skill backend-fastapi-python en Claude Code?
Ejecuta npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill backend-fastapi-python?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo deben estructurarse las funciones de servicio en este proyecto?
Los servicios deben implementarse como funciones sin estado en lugar de clases, donde el primer parámetro es siempre un AsyncSession.
¿Qué debo hacer si los campos de relación de SQLModel no aparecen en las respuestas de la API?
Los campos de relación de SQLModel no se incluyen por defecto; debes agregarlos explícitamente al model_config o utilizar un esquema de respuesta independiente.
¿Cómo manejo tareas en segundo plano que no deben fallar silenciosamente?
Dado que las BackgroundTasks se ejecutan después de enviar la respuesta, utiliza colas de tareas adecuadas como Celery o ARQ para tareas críticas que no puedan fallar silenciosamente.
¿Cuál es la forma correcta de cargar objetos relacionados después de un AsyncSession.refresh()?
Debido a que refresh() no carga las relaciones, debes volver a consultar el objeto usando .options(selectinload(...)) para recuperar los datos relacionados.