Agent skill
dev-server
Create and manage Python backend services using uv, FastAPI, Pydantic, SQLAlchemy, and AI libraries. Use this skill when the user asks to build a backend, API, or server-side application.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/server
Metadata
Additional technical details for this skill
- author
- Yuga Sun
- version
- 2026.01.29
SKILL.md
Server Development Skill
Instructions
Use this skill to scaffold and maintain backend services in the server/ directory. Follow the stack preferences and configuration details below.
Quick Start
- Initialize:
uv init. - Manager: Use
uvfor all dependency operations. - Framework: Setup
FastAPIwithPydantic. - Database: configure
SQLAlchemy(Async) +Alembic.
Core Stack Preferences
Project Management (uv)
Use uv for all Python project management (scaffolding, dependency management, virtual environments).
| Command | Description |
|---|---|
uv init |
Initialize a new project |
uv add <pkg> |
Add dependency |
uv add --dev <pkg> |
Add development dependency |
uv run <cmd> |
Run command in virtual environment |
uv venv |
Create virtual environment |
Project Location
The backend project should be initialized in the server/ directory.
Framework (FastAPI)
Use FastAPI for building APIs.
- Use
APIRouterfor modularizing routes. - Use
pydantic-settingsfor configuration management.
Database (SQLAlchemy + Alembic)
Use SQLAlchemy 2.0+ with AsyncIO support. Use Alembic for database migrations.
AI & LLM (LiteLLM + Docling)
- LiteLLM: For standardized access to various LLM providers.
- Docling: For parsing and processing documents.
References
Setup & Configuration
| Topic | Description | Reference |
|---|---|---|
| Project Setup | Using uv, strict python versioning, and environment variables | setup |
| API Development | FastAPI structure, error handling, and validation | api |
Data & Architecture
| Topic | Description | Reference |
|---|---|---|
| Database Access | Async SQLAlchemy strategies and Alembic migrations | database |
| AI Integration | using LiteLLM and Docling for AI features | ai |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?