Extending Pi

extending-pi

Guide for extending Pi — decide between skills, extensions, prompt templates, themes, context files, or custom models, then create and package them. Use when someone wants to extend Pi, add capabilities, create a skill, build an extension, or make a Pi package.

Dicklesworthstone/pi_agent_rust·0installs1.8Kstars

SKILL.md

Full skill instructions

Extending Pi

Help the user decide what to build and where to find guidance.

What to build

Goal	Build a…	Where
Teach Pi a workflow or how to use a tool/API/CLI	Skill	Read `skill-creator/SKILL.md` for detailed guidance
Give Pi a new tool, command, or runtime behavior	Extension	Read Pi docs: `docs/extensions.md`
Reuse a prompt pattern with variables	Prompt template	Read Pi docs: `docs/prompt-templates.md`
Set project-wide coding guidelines	Context file	`AGENTS.md` in project root or `.pi/agent/` — just markdown
Change Pi's appearance	Theme	Read Pi docs: `docs/themes.md`
Add a model or provider	Custom model	Read Pi docs: `docs/models.md` (JSON) or `docs/custom-provider.md` (extension)
Share any of the above	Package	Read Pi docs: `docs/packages.md`

Skill vs Extension — the fuzzy boundary

If bash + instructions can do it, prefer a skill (simpler, no code to maintain). If you need event hooks, typed tools, UI components, or policy enforcement, use an extension.

Examples:

"Pi should know our deploy process" → Skill (workflow instructions)
"Pi should confirm before rm -rf" → Extension (event interception)
"Pi should use Brave Search" → Skill (instructions + CLI scripts)
"Pi should have a structured db_query tool" → Extension (registerTool)

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/Dicklesworthstone/pi_agent_rust --skill extending-pi

View on GitHub

tests/ext_conformance/artifacts/npm/pi-extensions/extending-pi/SKILL.md

deepgram-hello-world
Create a minimal working Deepgram transcription example. Use when starting a new Deepgram integration, testing your setup, or learning basic Deepgram API patterns. Trigger with phrases like "deepgram hello world", "deepgram example", "deepgram quick start", "simple transcription", "transcribe aud...
0 installs
interactive-shell
Cheat sheet + workflow for launching interactive coding-agent CLIs (Claude Code, Gemini CLI, Codex CLI, Cursor CLI, and pi itself) via the interactive_shell overlay or headless dispatch. Use for TUI agents and long-running processes that need supervision, fire-and-forget delegation, or headless b...
0 installs
documenso-prod-checklist
Execute Documenso production deployment checklist and rollback procedures. Use when deploying Documenso integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "documenso production", "deploy documenso", "documenso go-live", "documenso launc...
0 installs
interactive-portfolio
Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities. Use when: portfolio, personal website, sho...
0 installs