---
title: Maintainer skills
description: Repo-local pi skills for developing yoke-pi itself.
---

# Maintainer skills

These skills are versioned under `.pi/skills/` and are available when running pi in this repository.

They are maintainer tools, not shipped user workflows. All of them use `disable-model-invocation: true`; invoke them explicitly.

| 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 and separate from the shipped `skills/` package catalog.

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