pi-dev-skills

A library of agent skills for developing with the pi coding agent in mind. Building extensions, registering tools, integrating with pi's event loop, and working with the surrounding ecosystem.

Each skill is self-contained and individually installable; the repo is a collection.

Skills

Skill	Description
pi-tool-repair-integration	Wrap extension-owned pi tools with @r3b1s/pi-repair-layer's adaptToolDefinition and adopt the optional-dependency fallback recipe so argument repair stays an end-user opt-in.
tmux-pilot-role-authoring	Create or edit a tmux-pilot subagent role: the subagent-roles YAML entry (routing, guards, worktree, style) plus the frontmattered agent-definition Markdown whose body becomes the spawned agent's standing instructions.

Installation

Install with the skills CLI:

# interactive picker across all skills in this repo
npx skills add r3b1s/pi-dev-skills

# list available skills without installing
npx skills add r3b1s/pi-dev-skills --list

# install a single skill
npx skills add r3b1s/pi-dev-skills --skill pi-tool-repair-integration

# one-shot use without installing
npx skills use r3b1s/pi-dev-skills@pi-tool-repair-integration | claude

Structure

Each skill lives in its own directory under skills/ and must be fully self-contained (the CLI installs only the selected skill's directory):

skills/
  <skill-name>/
    SKILL.md        # frontmatter (name, description) + core workflow
    metadata.json   # version, abstract, references
    resources/      # templates, catalogs, checklists the SKILL.md links to

Conventions for new skills:

• The frontmatter name matches the directory name — it is what --skill <name> selects on.
• SKILL.md may link to its own resources/, never to sibling skills or the repo root.
• Add a row to the skills table above.