Pi Claude Skills Extension — Development skill for Claude Code

pi-claude-skills-extension

A dependency-free [Pi](https://pi.dev) extension that loads [Agent Skills](https://agentskills.io/specification) from a project's `.claude/skills/` directory.

Install

Install globally from Git once this repository is pushed:

pi install git:github.com/nicbet/pi-claude-skills-extension

For local development:

pi install /path/to/pi-claude-skills-extension

Restart Pi after installation.

Development

Install dependencies with `bun install`. The complete local quality gate is:

bun run check

Individual targets are `bun run format`, `bun run format:check`, `bun run lint`, `bun run typecheck`, and `bun run test`.

Skills

The extension finds the nearest Git worktree root from Pi's working directory. If the worktree contains `.claude/skills/`, it adds that directory to Pi's skill paths. Outside a Git worktree, Pi's current working directory is used as the project root.

Pi recursively discovers skill directories containing `SKILL.md` and validates their frontmatter against the Agent Skills standard. The extension does not transform skill files.

.claude/skills/
└── my-skill/
    ├── SKILL.md
    ├── scripts/
    └── references/

---
name: my-skill
description: Explains what this skill does and when to use it.
---

# My Skill

Security

Treat `.claude/skills` as project-supplied instructions. Skills can direct the model to execute commands or use bundled scripts. The extension preserves Pi's project-trust boundary and, in interactive mode, prompts before loading skills from this directory. In non-interactive mode, use Pi's normal `--approve` flag or configure `defaultProjectTrust`.