# pi-superpowers-skills

Superpowers skills for the pi agent. Forked from [obra/superpowers](https://github.com/obra/superpowers).

## Skills included

| Skill | Description |
|-------|-------------|
| `systematic-debugging` | 4-phase root-cause process before any fix |
| `test-driven-development` | RED-GREEN-REFACTOR. No production code without a failing test |
| `verification-before-completion` | Verify before claiming "done" — evidence before assertions |
| `writing-plans` | Write implementation plans before touching code |
| `requesting-code-review` | Self-review checklist before merge |
| `receiving-code-review` | Rigorously process feedback, don't blindly apply |
| `finishing-a-development-branch` | Merge/PR/cleanup workflow when done |

## Upstream sync

This repo tracks a subset of the upstream [obra/superpowers](https://github.com/obra/superpowers) skills.

### Check for updates (dry-run)

```bash
./scripts/sync-upstream.sh --dry-run
```

### Apply updates

```bash
./scripts/sync-upstream.sh
# Review staged changes, then:
git commit -m "Sync skills from upstream"
git push
```

The script fetches `upstream/main`, compares the selected `skills/*` directories, and merges any changes.