Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"name": "robhowley"
},
"metadata": {
"description": "Python development tools for Claude Code"
"description": "Opinionated Python API development skills for AI coding agents."
},
"plugins": [
{
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "py-pit",
"version": "4.3.0",
"description": "A Claude Code plugin for Python development",
"description": "Opinionated Python API development skills for AI coding agents.",
"author": {
"name": "robhowley"
},
Expand Down
26 changes: 14 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,22 +2,13 @@

![version](https://img.shields.io/github/v/tag/robhowley/py-pit-skills)

Opinionated Python backend workflows for Claude Code.
Opinionated Python API development skills for AI coding agents (Pi, Claude Code).

`py-pit` encodes common backend development workflows as Claude/Pi skills for the modern Python API stack: FastAPI services, uv environments, SQLAlchemy models, Alembic migrations, configuration management, and CLI tooling.
`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

### Claude Code

Add the plugin marketplace, then install py-pit:

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

### pi
### Pi

Install from npm:

Expand All @@ -31,8 +22,19 @@ 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 |
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "@robhowley/py-pit-skills",
"version": "4.3.0",
"description": "Opinionated Python backend workflows as agent skills for FastAPI, uv, SQLAlchemy, Alembic, Click, and pytest",
"description": "Opinionated Python API development skills for AI coding agents (Pi, Claude Code).",
"keywords": [
"pi-package"
],
Expand Down
Loading