Pi: The Reusable Team Skill

The Stack

Tested Against

Prerequisites

• Pi (MIT): `npm install -g --ignore-scripts @earendil-works/pi-coding-agent`
• A model key/subscription (only needed to run the skill)
• A git repo/package to share the skill (for `pi install git:…`)

Steps

1. 1

   Scaffold the SKILL.md at Pi's skill-discovery path

   CI writes the skill to Pi's documented skills directory (`<config>/skills/<name>/SKILL.md`) with its required H1 heading, and confirms Pi's `install` subcommand exists (so the shared-package command is well-formed) — the deterministic half of 'encode once, share with one command.'

   export PI_CODING_AGENT_DIR="$PWD/.pi"
   pi --version >/dev/null || { echo "pi missing"; exit 1; }
   mkdir -p "$PI_CODING_AGENT_DIR/skills/triage-failing-test"
   cat > "$PI_CODING_AGENT_DIR/skills/triage-failing-test/SKILL.md" <<'EOF'
   # Triage Failing Test
   Use this skill when the user asks to triage a failing test.
   
   ## Steps
   1. Run the test suite and find the first failing test.
   2. Read that test and the code it exercises.
   3. Explain the likely root cause and propose the smallest fix.
   EOF
   test -s "$PI_CODING_AGENT_DIR/skills/triage-failing-test/SKILL.md" && echo "skill scaffolded: skills/triage-failing-test/SKILL.md"
   head -1 "$PI_CODING_AGENT_DIR/skills/triage-failing-test/SKILL.md" | grep -q "^# Triage Failing Test" && echo "skill has required H1 heading"
   pi install --help | grep -qi "Install a package" && echo "pi supports install subcommand (pi install git:github.com/org/pack)"

2. 2

   Run and share it (the model step, not checked by CI)

   Invoke with `/skill:triage-failing-test`, or let Pi auto-load it when the task matches. Share by bundling skills/prompts into a package: `pi install git:github.com/your-org/your-pi-pack` then `pi list`. The agent executing the skill calls a model, so CI doesn't run it.