pi-superpowers

A process-discipline skills bundle for pi — the minimal terminal coding agent by Mario Zechner.

Inspired by Claude Code's superpowers plugin, this package ships a set of Agent Skills that nudge pi toward better engineering habits: brainstorming before building, structured debugging, TDD, written plans, verification before claiming "done", and isolated work via git worktrees.

Skills auto-load and the model picks the right one based on your request — no slash-commands required.

Install

# From npm (once published)
pi install npm:pi-superpowers

# From git
pi install git:github.com/krone9/pi-superpowers

# From a local clone (for development)
pi install /absolute/path/to/pi-superpowers

Add -l to install into a project's .pi/settings.json instead of global.

Verify installation:

pi list

You should see the package listed; on next pi startup the skills appear in the header.

What's included

Each skill is a markdown file with name + description frontmatter. Pi loads the descriptions into its system prompt at startup; full instructions are pulled in on-demand when the model decides a skill applies (or when you force one with /skill:name).

| Skill | When pi will reach for it | |---|---| | using-superpowers | Bootstrap — instructs the model to check skills before responding | | brainstorming | New feature, vague goal, "what should we build…" | | writing-plans | Multi-step changes that should be planned before coding | | test-driven-development | Adding behavior that can be tested | | systematic-debugging | Bug reports, unexpected behavior, regressions | | verification-before-completion | Before claiming a task is done | | using-git-worktrees | Isolated feature/experiment branches | | dispatching-parallel-agents | 2+ independent tasks that can run concurrently | | writing-skills | Authoring a new skill |

Workflow skills (ported from Claude Code)

These mirror Andy's ~/.claude/skills/ set — process/logging/git helpers. Pi auto-loads them by description; you can also force-load any with /skill:<name>.

audit-structure, brief, changes, commit, debt, dependencies, log, nextsteps, optimise, restart, review, rollback, rules, scaffold, security, staging, status, wrapup

Customise

Skills are plain markdown — fork, edit, or add your own under skills/<your-skill>/SKILL.md. The name field must match the parent directory.

Caveat

Pi runs many providers. Forced skill-checking is prompt persuasion, not a tool the model is trained on. Capable models (Claude, GPT-4-class, Gemini Pro) follow the bootstrap reliably; smaller models may ignore it. The skills themselves work everywhere — only the always-check-first nudge depends on model strength.

Credit

Concept and skill names adapted from the Claude Code superpowers plugin by Anthropic. Reimplemented for pi's skills system. Not affiliated with Anthropic or pi.dev.

License

MIT