Agent Setup

Skills and prompts for pi.

Contents

Skills

Skill	Description
pdf	Extract text and tables from PDFs using pdftotext (simple) or pdfplumber (advanced)

Prompts

Prompt	Description
familiarize	Get oriented with a new codebase
improve	Suggest structural improvements to docs/agents organization
polish	Review session code changes for style and DRY
recall	Search for relevant past learnings not loaded at session start
reflect	End-of-session reflection - update docs and handovers
weigh	Weigh session discussion and propose 3 solutions with pros and cons

Extensions

Extension	Description
autoload-context	Auto-load docs/agents/context/*.md files into system prompt
noop	Plan without implementing - prefix prompts with /noop to get a plan instead of changes
self-update	Update pi and restart with current session via /update command

Installation

Skills

Clone this repo and add to your pi settings:

git clone https://github.com/brunohaid/agent-setup ~/agent-setup

Edit ~/.pi/agent/settings.json:

{
  "skills": {
    "customDirectories": ["~/agent-setup/skills"]
  }
}

Prompts

Symlink prompts to your pi prompts directory:

mkdir -p ~/.pi/agent/prompts
ln -s ~/agent-setup/prompts/*.md ~/.pi/agent/prompts/

Or symlink individually / copy them directly if you prefer.

Extensions

Symlink extensions to your pi extensions directory:

mkdir -p ~/.pi/agent/extensions
ln -s ~/agent-setup/extensions/*.ts ~/.pi/agent/extensions/

Usage

PDF Skill

The skill loads automatically when working with PDFs, or invoke directly:

/skill:pdf

Requires pdftotext (install via brew install poppler on macOS).

Prompts

• /familiarize - Get oriented with a new codebase
• /improve - Suggest improvements to docs/agents organization
• /polish - Review session code for style compliance and DRY
• /recall - Search for relevant past learnings
• /reflect - End-of-session reflection and doc updates
• /weigh - Propose 3 solutions with pros and cons for current discussion

Noop (Plan Mode)

Prefix any prompt with /noop to get a detailed plan instead of immediate implementation:

/noop Add caching to the API endpoints
/noop Refactor the database connection pooling

The agent will describe what files it would modify and what changes it would make, without actually making them. Useful for reviewing proposed changes before committing to them.

Self-Update

Run /update to update pi to the latest version and automatically restart with your current session. No manual restart required.