pi skills (shared)

Shared pi skills and extensions used by the team. Add this repo as a local package in pi to load them.

What's included

Skills

• buildkite-cli — use the local bkci CLI for LLM-friendly Buildkite JSON (builds, logs, artifacts, auth scopes).
• buildkite-mcp (deprecated) — legacy mcporter/mcp-remote Buildkite access kept for compatibility.
• buildkite-playwright-failures — extract failed-only Playwright tests from Buildkite logs.
• gh-address-comments — fetch PR review comments, apply fixes with build verification, and commit each fix atomically. (Derived from skills.sh, Apache 2.0)
• github — use the gh CLI for issues, PRs, and runs.
• github-repo-search — search any repo via gh search and deep-read files via the GitHub API without cloning.
• multi-review — multi-model PR review workflow.
• multi-agent-security-review — tracer/resolver/bypass workflow for security reviews with a runner that spawns independent pi sessions.
• tmux — drive tmux sessions for interactive tools.

Extensions

• buildkite-failures — /bk-playwright-errors <url> shows a selectable list of failing Playwright tests and opens the Buildkite job in a browser.
• cronjob — /cron command for scheduled prompts (cron expressions), optional job names, and queued runs while busy.
• loop — /loop command that keeps a follow-up loop running until a breakout condition is met.
• notify — desktop notification when the agent finishes and waits for input.
• ssh — delegate all tool operations (read, write, edit, bash, grep, find, ls) to a remote machine via SSH. Usage: pi --ssh user@host or pi --ssh user@host:/remote/path. Requires SSH key-based auth and bash on remote. Based on the example from pi-mono, but patched so remote tool calls work properly.
• side-by-side-diff — overrides the built-in edit tool renderer to show side-by-side diffs with syntax highlighting and compact/expanded output.
• start-design-plan — Claude-style design workflow extension with /start-design-plan and /resume-design-plan, plus ask_user_question and design_plan_tracker tools. Ported from concepts in ed3d-plan-and-execute (https://github.com/ed3dai/ed3d-plugins). Extension-specific license in extensions/start-design-plan/LICENSE.
• todo-overlay — shows TODO.md/todo.md from the current working directory in a right-side non-capturing overlay, with auto-refresh and keyboard shortcuts for toggle/scroll.
• pi-skills-update-checker — checks for new commits on startup and shows a widget when updates are available.
• nutrient-bug — lightweight read-only Zendesk + Jira issue context workflow with /bug, /bug-view, and nutrient_bug_get_context.
• pi-self — adds the pi_run tool for spawning pi subprocesses (required by multi-agent-security-review).

Usage

Install as a project-local package (writes .pi/settings.json):

pi install -l /absolute/path/to/pi-skills-nutrient

Install directly from GitHub:

pi install -l https://github.com/PSPDFKit-labs/pi-skills

Or add it manually:

{
  "packages": [
    "/path/to/pi-skills-nutrient"
  ]
}

After pulling updates, run /reload in pi to reload extensions, skills, and prompts.

Layout

• skills/ — each skill lives in its own folder with a SKILL.md.
• extensions/ — TypeScript extensions loaded by pi.

Adding content

1. Add a new folder under skills/ or a new .ts file under extensions/.
2. Update this README to list it.
3. Commit the change.