feat(pi): implement milestone M5 - package surface

README.md

@@ -2,6 +2,8 @@
 
 Cross-agent skill collection for **Codex**, **Claude Code**, **OpenCode**, and **Cursor**.
 
+Pi package support is also included for the pi-native variants in this repo.
+
 This repo is organized similarly to `obra/superpowers` and is designed to scale to many skills over time.
 
 ## Goals
@@ -91,3 +93,28 @@ ai-coding-skills/
 ## Compatibility Policy
 
 Each skill should explicitly document agent compatibility and any prerequisites directly in its own `SKILL.md`.
+
+## Pi Package
+
+The repo root now includes a pi package manifest that ships only the pi-specific surface:
+
+- `skills/*/pi/` for the five supported skill families
+- `skills/reviewer-runtime/pi/`
+- `docs/PI*.md`
+- `scripts/verify-pi-resources.sh`
+
+Install it into project-local pi settings from this checkout with:
+
+```bash
+pi install -l /absolute/path/to/ai-coding-skills
+pi list
+```
+
+Before publishing or sharing a tarball, run:
+
+```bash
+./scripts/verify-pi-resources.sh
+npm pack --dry-run --json
+```
+
+Additional pi-specific guidance lives in [docs/PI.md](docs/PI.md).