Python Fastapi Playbook

Operational playbook for FastAPI + Pydantic v2 async services — event-loop discipline, boundary validation, dependency lifetimes, response_model leaks, async ORM N+1s. Read in full at the start of every task on this team.

49 stars 3 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add toffyui/ccteams

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add toffyui/ccteams --skill python-fastapi-playbook
Manual install
git clone --depth 1 https://github.com/toffyui/ccteams.git /tmp/ccteams
mkdir -p ~/.claude/skills
cp -r /tmp/ccteams/teams/python-fastapi/skills/python-fastapi-playbook ~/.claude/skills/python-fastapi-playbook

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Python FastAPI Playbook

This is the literal procedure a frontier model follows when building or fixing
FastAPI services. Follow it step by step; the order is the point. FastAPI +
async is unforgiving in one specific way: code that *works in a unit test*
(one request, no concurrency) can *stall the whole process under load* because
a single blocking call in an `async def` freezes the event loop for every
other request. The type checker will not catch that. Those checks are yours.

## Operating loop

1. **Read `pyproject.toml` / `requirements.txt` FIRST — the Pydantic major
   version changes everything.** `grep -E "pydantic" pyproject.toml
   requirements.txt` or `python -c "import pydantic; print(pydantic.VERSION)"`.
   v1 and v2 have different method names, validator decorators, and config
   styles (catalog below). Writing v2 idioms into a v1 project (or vice versa)
   produces import errors or silent no-ops. Note the package manager too:
   `poetry.lock` → `poetry run`, `uv.lock` → `uv run`, else `python -m`.
2. **Find the local dialect and mirror it.** Before writing a route, read two
   existing routers: `grep -rn "APIRouter\|@router\.\|@app\." --include="*.py" .`.
   Copy the project's router registration, response envelope, error-raising
   style (`HTTPException` vs custom handler), and dependency wiring exactly. A
   "cleaner" pattern that differs from the neighbors is a defect here.
3. **Find the schema and dependency patterns and mirror them.** Read one
Read the full skill on GitHub

Details

Skill name
python-fastapi-playbook
Path
teams/python-fastapi/skills/python-fastapi-playbook/SKILL.md
License
MIT
Repo updated
31 August 2026

FAQ

What does the Python Fastapi Playbook skill do?

Operational playbook for FastAPI + Pydantic v2 async services — event-loop discipline, boundary validation, dependency lifetimes, response_model leaks, async ORM N+1s. Read in full at the start of every task on this team.

How do I install the Python Fastapi Playbook skill?

Claude Code plugin: /plugin marketplace add toffyui/ccteams. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Python Fastapi Playbook popular?

It lives in toffyui/ccteams, which has 49 GitHub stars and 3 forks.

Related skills

Choose Team

49

toffyui/ccteams

Pick and apply the best ccteams agent team for a described need using natural language — reads team metadata, selects the closest match, and applies it.

AI, LLMs & Agents

Debug Playbook

49

toffyui/ccteams

Operational playbook for systematic debugging — hypothesis ledgers, discriminating experiments, mechanism sentences, minimal fixes, sibling hunts. Read in full at the start of every bug investigation.

Software Development

Django Playbook

49

toffyui/ccteams

Operational playbook for Django + DRF — settings/version detection, ORM loading strategy, migration discipline, serializer field hygiene, timezone rules, and exact verification commands. Read in full at the start of every task on this team.

Software Development

Rails Playbook

49

toffyui/ccteams

Operational playbook for Ruby on Rails — version/test-framework detection, ActiveRecord loading strategy, callback boundaries, migration discipline, and exact verification commands. Read in full at the start of every task on this team.

Software Development

Go API Playbook

49

toffyui/ccteams

Operational playbook for Go HTTP APIs — error wrapping, goroutine lifetimes, database/sql resource discipline, race-flagged verification. Read in full at the start of every task on this team.

Software Development

Runtime Frameworks

49

dynamics365ninja/d365fo-cli

Use the D365FO platform frameworks that decide behaviour at runtime — Feature Management, the SysExtension plug-in factory, telemetry and infolog, and the Global Address Book. Invoke when the user asks to add a feature flag, replace an if/switch chain with a registered strategy, log or capture infolog output, or read a party's address or contact details.

Software Development26

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.