# pi-result-handling

Skill for presenting Pi helper output correctly in Claude Code, Cursor and other IDEs. Preserves review structure, file paths and line numbers as reported.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2800 installs · ★ 92
- Author: Agents365-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Agents365-ai/365-skills/tree/HEAD/plugins/pi-plugin-cc/skills/pi-result-handling/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/pi-result-handling

## What it does

The skill tells the agent how to present Pi helper results. Review findings are ordered by severity, file paths and line numbers are kept verbatim. When Pi marks something as an inference or open question, that distinction is preserved. If there are no findings, the agent states that explicitly and keeps the residual-risk note short.

After a review, the agent will stop and show the list of findings without making changes. To apply fixes, you must specify which issues to address. Auto-fixing is forbidden, even when the bug is obvious. If Pi returns an error or fails to start (missing binary, no provider configured), the agent will show the most actionable `stderr` lines and suggest `/pi:setup`.

The skill is not user-invocable — it activates in the background when other Pi commands return data.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill pi-result-handling -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pi-result-handling/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pi-result-handling/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill pi-result-handling -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pi-result-handling/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill pi-result-handling -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pi-result-handling/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Agents365-ai/365-skills pi-result-handling
```

2. **Manually: put the files in place**
- File: `.github/skills/pi-result-handling/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill pi-result-handling -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/pi-plugin-cc/skills/pi-result-handling
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pi-result-handling/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill pi-result-handling -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Agents365-ai/365-skills/tree/HEAD/plugins/pi-plugin-cc/skills/pi-result-handling/SKILL.md

## When to use it
- preserve Pi helper output structure and finding order by severity
- keep file paths and line numbers exactly as Pi reports them
- distinguish facts, inferences and open questions in the report
- stop the agent after review, preventing code edits without permission
- surface diagnostics when Pi fails to start or returns an error

## Example prompts
- "Run a Pi review on this file" — the skill takes Pi output and shows findings ordered by severity
- "Check the project with Pi helper" — after the review completes, the agent stops and asks what to fix
- "Fix the second bug from the Pi list" — the skill passes the command, and only the named bug will be touched

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [codebase-design](https://affpapa.org/en/nevibecode/skills/codebase-design.md) — skill · 850344 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs

From the same set: [agents365-ai/365-skills](https://affpapa.org/en/nevibecode/by/agents365-ai/365-skills.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md