---
slug: "uadgj-pi-superpowers-support"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/gadgj/pi-superpowers-support@main/README.md"
repo: "https://github.com/gadgj/pi-superpowers-support"
source_file: "README.md"
branch: "main"
---
# pi-superpowers-support

A pi extension that provides **TodoWrite**, **Task**, and **Skill** tools for official [superpowers](https://github.com/obra/superpowers) compatibility.

## Why This Extension Is Needed

pi 内置只有 4 个工具：`read`, `bash`, `edit`, `write`。

superpowers 需要以下工具：

| 工具 | pi 内置 | superpowers 需要 | 来源 |
|------|---------|-----------------|------|
| TodoWrite | ❌ | ✅ | 本扩展 |
| Task | ❌ | ✅ | 本扩展 (Agent 别名) |
| Skill | ❌ | ✅ | 本扩展 |
| Agent | ❌ | ✅ | `@tintinweb/pi-subagents` |

### 为什么需要 Skill 工具？

superpowers 的 `using-superpowers/SKILL.md` 明确要求：

1. **"Use the `Skill` tool"** - 必须使用 Skill 工具加载 skills
2. **"Never use the Read tool on skill files"** - 禁止用 read 工具

虽然 pi 原生支持 skill 发现（系统提示列出 skills），但 superpowers 的流程图和工作流设计依赖于调用 `Skill` 工具。

## Installation

```bash
# 1. Install superpowers (official)
pi install https://github.com/obra/superpowers

# 2. Install pi-subagents (for Task/Agent tool)
pi install npm:@tintinweb/pi-subagents

# 3. This extension is auto-loaded from ~/.pi/agent/extensions/
```

## Tools Provided

### TodoWrite

Track tasks with status:

```
TodoWrite({
  todos: [
    { id: "1", content: "Design API", status: "pending", priority: "high" },
    { id: "2", content: "Implement", status: "in_progress" },
    { id: "3", content: "Write tests", status: "completed" }
  ]
})
```

### Task

Dispatch subagents (alias for Agent):

```
Task({
  subagent_type: "Explore",
  prompt: "Find all auth-related files",
  description: "Find auth files",
  run_in_background: true
})
```

### Skill

Load skill content:

```
Skill({ skill: "brainstorming" })
Skill({ skill: "test-driven-development" })
```

## Commands

| Command | Description |
|---------|-------------|
| `/todos` | Show current todo list |
| `/todo-clear` | Clear all todos |

## Available Skills (from superpowers)

- brainstorming, test-driven-development, systematic-debugging
- writing-plans, executing-plans, subagent-driven-development
- dispatching-parallel-agents, using-git-worktrees
- finishing-a-development-branch, requesting-code-review
- receiving-code-review, verification-before-completion, writing-skills

## License

MIT