py-pit

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

Pi

Install from npm:

pi install npm:@robhowley/py-pit-skills

Or directly from GitHub:

pi install https://github.com/robhowley/py-pit-skills

Claude Code

Add the plugin marketplace, then install py-pit:

/plugin marketplace add robhowley/py-pit-skills
/plugin install py-pit@py-pit-skills

Skills

Skills activate automatically when the agent detects relevant intent — no manual prompting required.

| Skill | Activates when LLM detects | |----------------------|--------------------------------------------------------------------------------------------| | 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 |