# Repo-local maintainer skills

These pi skills are versioned under `.pi/skills/` and are available when running pi in this repository. They are maintainer tools, not shipped user workflows.

All maintainer skills have `disable-model-invocation: true`; invoke them explicitly.

## Commands

| Command                | Purpose                                                              |
| ---------------------- | -------------------------------------------------------------------- |
| `/skill:yoke-create`   | Create or port yoke-pi skills and their docs.                        |
| `/skill:yoke-release`  | Release yoke-pi using `package.json` as the version source of truth. |
| `/skill:yoke-validate` | Validate changed skills and docs for pi compatibility.               |
| `/skill:journal`       | Append concrete session changes to `journal.md`.                     |

## Why `.pi/skills/`

pi auto-discovers project-local skills from `.pi/skills/`. This keeps maintainer tools repo-scoped: they are available while developing yoke-pi, but separate from the shipped `skills/` catalog.

The repository `.gitignore` ignores most `.pi/` runtime state but explicitly keeps `.pi/skills/` versioned.

## Migration note

These replace the old local Claude Code tools from `.claude/skills/` and `.claude/commands/` for pi-based development.