https://github.com/mattpocock/skills

Below, my fork focusses on integrating with pi.dev agent harness.

By: Geoff Bremner

This guide explains how to integrate Matt Pocock's skills into your pi coding agent instance.

You need to have pi installed and configured. See [pi documentation] (https://pi.dev/) for installation instructions.

cd ~/Documents
git clone https://github.com/geoffbremner/skills

This document assumes you are working in ~/Documents directory.

Now you can manage and iterate on the skills built for your pi development flows.

Create or edit the pi settings file at ~/.pi/agent/settings.json.

To create:

mkdir -p ~/.pi/agent
cat > ~/.pi/agent/settings.json << 'EOF'
{
  "skills": [
    "~/Documents/skills/skills/engineering",
    "~/Documents/skills/skills/productivity",
    "~/Documents/skills/skills/misc"
  ]
}
EOF

To edit:

vim ~/.pi/agent/settings.json

Add the skills array to your existing JSON:

{
  "model": "your-existing-model",
  "skills": [
    "~/Documents/skills/skills/engineering",
    "~/Documents/skills/skills/productivity",
    "~/Documents/skills/skills/misc"
  ]
}

Note: We only include engineering, productivity, and misc directories. The personal, in-progress, and deprecated directories are intentionally excluded.

cp STARTER_AGENTS.md ~/.pi/agent/AGENTS.md

This context will be loaded for every pi session. Feel free to read this and modify it to your liking.

pi install npm:@curl.md/pi

This allows you to paste URLs and pi will fetch them

Reload skills in pi:

/reload

Then verify skills are loaded by asking:

What skills do you have available?

Note: This list may become outdated as Matt's repo evolves. Fork the repo (Step 1) to maintain your own stable version.

Once configured, you'll have access to:

• /skill:diagnose — Debug hard bugs with a disciplined loop
• /skill:grill-with-docs — Align on requirements and build shared language
• /skill:triage — Triage issues through state machine
• /skill:improve-codebase-architecture — Find deepening opportunities
• /skill:tdd — Test-driven development with red-green-refactor
• /skill:to-issues — Break plans into vertical-slice issues
• /skill:to-prd — Turn conversation into a PRD
• /skill:zoom-out — Get broader context on code
• /skill:prototype — Build throwaway prototypes

• /skill:caveman — Ultra-compressed communication mode
• /skill:grill-me — Get interviewed about your plan
• /skill:handoff — Create handoff document for another agent
• /skill:write-a-skill — Create new skills

• /skill:git-guardrails-claude-code — Block dangerous git commands
• /skill:migrate-to-shoehorn — Migrate to @total-typescript/shoehorn
• /skill:scaffold-exercises — Create exercise structures
• /skill:setup-pre-commit — Set up Husky pre-commit hooks

These skills work with all models supported by pi (Claude, GPT-4, local models, etc.). The configuration is model-agnostic.

To get Matt's latest updates:

cd ~/Documents/skills
git pull upstream main
git push origin main  # push to your fork

Then reload skills in pi:

/reload

1. Check the path in ~/.pi/agent/settings.json matches where you cloned the repo
2. Run /reload
3. Verify JSON syntax is valid (no trailing commas, proper quotes)