This repository contains skills, extensions, and themes for the Pi coding agent.
Custom skills located in skills/:
| Skill | When to use | Tools | Scripts/Files |
|---|---|---|---|
| show-me | Prove that code works — run demos, record terminal sessions | Bash, Read | scripts/kitty_screenshot.sh, scripts/wait_for_text.sh |
| summarize | Convert URL/PDF/DOCX to Markdown, summarize content | Bash, Read | to-markdown.mjs |
| google-workspace | Access Drive, Docs, Calendar, Gmail, Sheets without MCP | Bash | scripts/auth.js, scripts/workspace.js |
| github | Interact with GitHub — PRs, issues, CI runs, API queries | Bash | gh CLI |
| web-browser | Interact with web pages — click, fill forms, navigate | Bash | scripts/*.js (CDP) |
| cli-tools | Reference for selecting tools — jq, fx, gh, sqlite-utils, etc. | (reference only) | — |
| update-changelog | Update CHANGELOG.md before releases | (reference only) | — |
| brainstorming-requirement | Refine ideas into designs through structured questioning | ask_user, write | — |
- Recording demos: Use
show-meto prove code works - Data extraction: Use
summarizefor docs,cli-toolsfor JSON - GitHub ops: Use
githubfor PRs, issues, CI - Web automation: Use
web-browserfor browser interaction - Google Workspace: Use
google-workspacefor Drive/Docs/Calendar - Requirements: Use
brainstorming-requirementbefore coding
Pi extensions located in pi-extensions/:
- answer (
answer.ts): Interactive Q&A extension. Extract questions from assistant messages and answer them one by one (/answerorCtrl+.). - context (
context.ts): Visualize current context usage (tokens, cost, loaded files/skills) via/context. - files (
files.ts): Interactive file browser (/filesorCtrl+Shift+o) with git status, quick look (Ctrl+Shift+r), and finder reveal (Ctrl+Shift+f). - notify (
notify.ts): Sends desktop notifications (Linux/notify-send) when the agent completes a turn. - session-breakdown (
session-breakdown.ts): Visualize session history (tokens/cost/messages) over 7/30/90 days via/session-breakdown. - todos (
todos.ts): Full-featured Markdown-based TODO manager (/todos). Supports listing, creating, claiming, and updating tasks with file locking and TUI. - uv (
uv.ts): Intercepts Python commands (pip,poetry) to suggest or redirect touvequivalents for faster package management.
Custom themes located in pi-themes/.
Custom prompt templates located in commands/.
You can install this package directly from GitHub or npm (once published).
Install globally:
pi install git:github.com/pcaro/pcaropiOr install for a specific project (saves to .pi/settings.json):
pi install -l git:github.com/pcaro/pcaropiClone the repository and install it as a local package:
git clone https://github.com/pcaro/pcaropi.git
pi install ./pcaropiThe answer extension helps you systematically answer multiple questions from the assistant.
- When the assistant asks multiple questions, run the
/answercommand or useCtrl+.shortcut. - Pi will extract the questions and present an interactive form.
- Fill in your answers and submit.
- The answers are sent back to the assistant as a single structured message.
The todos extension provides a full-featured markdown-based task manager.
- Run
/todosto open the interactive TUI. - Use arrow keys to navigate tasks.
- Press
Enterto see actions (work, refine, close, etc.). - Use
Ctrl+Shift+wto quickly "work" on a task (loads it into context). - Use
Ctrl+Shift+rto "refine" a task (starts a refinement chat).
The files extension lets you browse and manage files without leaving pi.
- Run
/filesor pressCtrl+Shift+oto open the file browser. - It shows files in the current git tree and files referenced in the session.
- Filter by typing.
- Actions include: Reveal in Finder, Open, Quick Look (
Ctrl+Shift+r), Edit, Add to prompt.
- Clone the repo.
- Run
npm install. - Make changes to extensions or skills.
- Test by installing the local path:
pi install .(in the repo root).
ISC