pi-skills

Curated agent skills for pi. Battle-tested across multiple projects.

Install

pi install git:github.com/khairold/pi-skills

Or try without installing:

pi -e git:github.com/khairold/pi-skills

Skills

🔧 Core Workflow (multi-session builds)

These three skills work together to manage projects that span multiple agent sessions:

Skill	Description
phased-plan	Turn a spec into a phased build plan with .plan/ directory (PLAN.md, MEMORY.md, DRIFT.md, SESSION-LOG.md)
execute-phase	Human-attended execution — orient, confirm scope, execute, update plan files
autopilot-execute	Unattended execution — agent reads plan, does work, verifies build, updates plan, exits. Designed for the Ralph Wiggum loop
close-plan	Close a completed .plan/ — persist decisions/gotchas into project docs, clean up

🧪 Development

Skill	Description
lint-fix	Drive typecheck + lint to zero errors/warnings. Auto-detects tooling (ESLint, Biome, framework wrappers). Fixes by pattern, not by file.
responsive-audit	Visual responsive audit using dev-browser — screenshots at breakpoints, identifies issues, produces fix plan
autoresearch-create	Autonomous experiment loop — try ideas, measure, keep or discard. Requires pi-autoresearch extension for custom tools.

🏗️ Architecture

Skill	Description
deep-modules-audit	Audit for "agent debt" — code structured for human IDE navigation instead of AI tool-call navigation. Produces refactoring plan.
docs-audit	Audit docs for staleness, contradictions, duplication. Produces reduction plan.
living-design-system	Build a design system that renders real app components with fixture data, independent of the backend

🔍 Discovery

Skill	Description
find-skills	Search and install skills from the open agent skills ecosystem via npx skills find

Selective Install

Only want some skills? Use package filtering in your settings:

{
  "packages": [
    {
      "source": "git:github.com/khairold/pi-skills",
      "skills": [
        "skills/phased-plan",
        "skills/execute-phase",
        "skills/autopilot-execute",
        "skills/lint-fix"
      ]
    }
  ]
}

Autopilot Scripts

The scripts/ directory contains the shell wrapper scripts for unattended execution:

# Copy to your project root
cp $(pi-skills-path)/scripts/autopilot.sh ./
cp $(pi-skills-path)/scripts/autopilot-dashboard.sh ./
chmod +x autopilot.sh autopilot-dashboard.sh

# Create config
cat > autopilot.config << 'EOF'
BUILD_CMD="npm run typecheck && npm run lint"
PROJECT_DIR="."
EOF

# Run
./autopilot.sh                    # Terminal 1: execute
./autopilot-dashboard.sh          # Terminal 2: watch progress

See scripts/autopilot.sh for all options (--dry-run, --continuous, --phase N, --max N, --model).

License

MIT