Pi Extension Dev

End-to-end workflow for developing, debugging, configuring, and shipping pi-coding-agent extensions and pi packages. Use when building or maintaining extensions, skills, prompt templates, themes, settings.json setups, provider integrations, or when updating this skill after pi releases. Do NOT use for general coding questions unrelated to pi extension development.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add bolasblack/claude-skills --skill pi-extension-dev
Manual install
git clone --depth 1 https://github.com/bolasblack/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/skills/pi-extension-dev ~/.claude/skills/pi-extension-dev

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Pi Extension Development

Build production-grade customization for `@mariozechner/pi-coding-agent` without forking core internals.

This skill is organized for progressive disclosure:
- This file: execution workflow
- `references/`: detailed technical guidance
- `templates/`: copy-paste starter files

## When to use this skill

Use this skill when you need to:
1. Build or modify an extension (tools, commands, events, UI, provider integrations)
2. Configure resource loading (`settings.json`, discovery paths, package sources)
3. Package and distribute reusable resources as a pi package (npm/git/local)
4. Validate extension behavior across interactive, print, json, and rpc modes
5. Update extension docs/skills after pi version changes

## Quick workflow

1. **Scope the request**
   - Identify target resource type(s): extension / skill / prompt / theme / package / settings
   - Identify runtime mode(s): interactive, print, json, rpc

2. **Pick implementation shape**
   - Small logic: single `*.ts` extension file
   - Multi-module logic: extension directory with `index.ts`
   - Team sharing: pi package with `pi` manifest in `package.json`

   **Model selection policy:** see `references/01-extension-api-cheatsheet.md` (subagent model policy section).

3. **Implement safely**
   - Add tool output truncation
   - Add guardrails for destructive operations (`tool_call` gate)
   - Ensure non-interactive compatibility (`ctx.hasUI` checks)

4. **Configure loading**
Read the full skill on GitHub

Details

Skill name
pi-extension-dev
Path
skills/pi-extension-dev/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Pi Extension Dev skill do?

End-to-end workflow for developing, debugging, configuring, and shipping pi-coding-agent extensions and pi packages. Use when building or maintaining extensions, skills, prompt templates, themes, settings.json setups, provider integrations, or when updating this skill after pi releases. Do NOT use for general coding questions unrelated to pi extension development.

How do I install the Pi Extension Dev skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add bolasblack/claude-skills --skill pi-extension-dev. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Pi Extension Dev popular?

It lives in bolasblack/claude-skills, which has 5 GitHub stars and 0 forks.

Related skills

Caveman

5

bolasblack/claude-skills

Terse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief", "less tokens". Stays on until "stop caveman" or "normal mode".

Images, Video & Audio

Agent Centric

5

bolasblack/claude-skills

Track decisions (AGD) with validation and indexing. Use when making design decisions, recording important choices, discussing trade-offs, or when user mentions AGD or decision record.

AI, LLMs & Agents

Codex

5

bolasblack/claude-skills

OpenAI Codex second opinion via the codex CLI — three modes. Review: independent diff review with a pass/fail gate. Challenge: adversarial pass that tries to break the code. Consult: ask Codex anything, with session continuity for follow-ups. Use when the user says "codex review", "codex challenge", "ask codex", or wants a second opinion from Codex.

Software Development

Plugin Developer

8

Freddy-CHEN-ux/00_claude_skills

Create and maintain Claude Code plugins following established patterns

Software Development

Philosophy of Software Design

5

vnovakovits/claude-skills

Apply John Ousterhout's "A Philosophy of Software Design" (2018; 2nd ed. 2021) — design as the fight against complexity. Covers complexity's symptoms (change amplification, cognitive load, unknown unknowns) and causes (dependencies, obscurity), strategic vs tactical programming, deep vs shallow modules, information hiding and leakage, temporal decomposition, somewhat-general-purpose interfaces, different layer different abstraction, pass-through methods, pulling complexity downwards, defining errors out of existence, design it twice, comments as design, and the red-flags catalogue. Adds the de

Software Development

Pragmatic Programmer

5

vnovakovits/claude-skills

Apply the broad heuristics from Andy Hunt & Dave Thomas's "The Pragmatic Programmer" (1999, 20th-anniversary ed. 2019) — DRY, orthogonality, tracer bullets, reversibility, programming by coincidence, design by contract, broken windows, knowledge portfolio, good-enough software, and the dozens of tips that shape a craftsperson's everyday judgment. Use when stuck on a non-pattern-specific problem, when reasoning about engineering trade-offs, when picking up a new technology, when growing as a developer, or when articulating habits and stances that don't fit neatly into any single methodology.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.