py-pit — плагин для Claude Code: Python API по шаблонам
Набор скиллов для разработки Python API: FastAPI, uv, SQLAlchemy, Alembic. Агент сам подхватывает нужный скилл, когда видит подходящую задачу.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install py-pit@claude-communityЧто делает py-pit
py-pit — плагин для Claude, который задаёт агенту определённые шаблоны разработки Python API. Внутри шестнадцать скиллов: fastapi-init для нового сервиса, uv для окружений и зависимостей, sqlalchemy-models и alembic-migrations для моделей и миграций, pydantic-schemas для схем запросов и ответов, settings-config для переменных окружения, click-cli и click-cli-linter для консольных утилит. Есть скиллы под тесты (pytest-service), обработку ошибок (fastapi-errors), Docker Compose (dockerize-service), корреляцию запросов и интеграцию с внешними API.
Скиллы включаются сами, когда агент распознаёт намерение — вручную вызывать их не нужно. Над остальными стоит implementation-protocol: он запускается на любой нетривиальной задаче и разводит работу по доменным скиллам. Это и есть главное отличие от россыпи отдельных инструкций: порядок действий задаёт один скилл, а не вы.
Плагин рассчитан на конкретный стек. Если в проекте Django, Flask или poetry, часть скиллов просто не сработает — они написаны под FastAPI, uv и SQLAlchemy 2.x. Ставить есть смысл, когда вы начинаете новый сервис на этом стеке или хотите привести существующий к тем же шаблонам.
Какие задачи решает
- развернуть новый сервис на FastAPI с нуля
- перевести проект с pip или poetry на uv
- описать модели SQLAlchemy 2.x и связи между ними
- сгенерировать миграцию Alembic и проверить diff
- настроить переменные окружения через pydantic-settings
Примеры запросов агенту
- Создай новый сервис на FastAPI с эндпоинтом для заказов
- Переведи зависимости проекта с poetry на uv
- Опиши модели SQLAlchemy для пользователей и заказов и подготовь миграцию Alembic
Как установить py-pit
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install py-pit@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о py-pit
Как установить py-pit в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add anthropics/claude-plugins-community. Затем установите плагин: /plugin install py-pit@claude-community.
Что делает py-pit?
Это набор скиллов по разработке Python API. Они покрывают FastAPI, uv, SQLAlchemy, Alembic, Pydantic, Click, тесты и Docker, а скилл implementation-protocol распределяет работу между ними.
Нужно ли вызывать скиллы вручную?
Нет. Скиллы активируются сами, когда агент распознаёт подходящую задачу — например, просьбу создать сервис или настроить миграции.
Исходный текст
SKILL.md · MIT
# 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 |
© robhowley · MIT · robhowley/py-pit-skills
