https://github.com/robhowley/py-pit-skills
Opinionated Python API backend workflows for Pi and Claude Code (FastAPI, uv, SQLAlchemy, Alembic).
https://github.com/robhowley/py-pit-skills
alembic claude-code fastapi pi python sqlalchemy uv
Last synced: 3 months ago
JSON representation
Opinionated Python API backend workflows for Pi and Claude Code (FastAPI, uv, SQLAlchemy, Alembic).
- Host: GitHub
- URL: https://github.com/robhowley/py-pit-skills
- Owner: robhowley
- License: mit
- Created: 2026-03-07T18:59:35.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-14T19:25:00.000Z (3 months ago)
- Last Synced: 2026-03-15T03:55:23.762Z (3 months ago)
- Topics: alembic, claude-code, fastapi, pi, python, sqlalchemy, uv
- Language: Shell
- Homepage:
- Size: 77.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```bash
pi install npm:@robhowley/py-pit-skills
```
Or directly from GitHub:
```bash
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 |
|----------------------|--------------------------------------------------------------------------------------------|
| `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 |