Opinionated Python API development skills for AI coding agents (Pi, Claude Code).
py-pit encodes opinionated Python API development patterns as skills for AI coding agents — works with both Pi and Claude Code. Covers the modern Python API stack: FastAPI services, uv environments, SQLAlchemy models, Alembic migrations, configuration management, and CLI tooling.
Install from npm:
pi install npm:@robhowley/py-pit-skillsOr directly from GitHub:
pi install https://github.com/robhowley/py-pit-skillsAdd the plugin marketplace, then install py-pit:
/plugin marketplace add robhowley/py-pit-skills
/plugin install py-pit@py-pit-skills
Skills activate automatically when the agent detects relevant intent — no manual prompting required.
| Skill | Activates when LLM detects |
|---|---|
implementation-protocol |
any non-trivial feature implementation — orchestrates domain skills below |
fastapi-init |
new FastAPI service, scaffold an API, new microservice |
uv |
dependency management, lockfiles, env setup, migration from pip/poetry |
click-cli |
designing or generating a new Click CLI |
click-cli-linter |
auditing or improving an existing Click CLI |
pydantic-schemas |
request/response schema design, Pydantic v2 models, schema patterns |
code-quality |
linting setup, Ruff, pre-commit, code health tooling |
dockerize-service |
local dev Docker Compose setup, containerizing a project |
settings-config |
environment variable management, pydantic-settings, replacing os.getenv |
sqlalchemy-models |
ORM model design, SQLAlchemy 2.x patterns, relationships, migration-ready schema |
alembic-migrations |
adding Alembic, generating migrations, reviewing autogenerate diffs, safe schema evolution |
fastapi-errors |
FastAPI error handling, exception hierarchy, consistent API error responses |
pytest-service |
writing tests for a FastAPI service, SQLAlchemy test fixtures, DI overrides, test setup |
request-correlation |
request tracing, correlation IDs, observability wiring, propagating context across task/job boundaries |
http-client-integration |
outbound API calls, building a vendor client, introducing retries and timeouts, replacing ad-hoc HTTP usage |
background-jobs-boundaries |
background task guardrails, misuse of FastAPI BackgroundTasks, when to use a real job system |