pi-cli-runtime — Claude Code skill: Pi task handoff
This skill defines how a forwarding subagent sends requests to the Pi runtime through a helper script. Use it to route diagnosis, research, or code-change requests.
npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a claude-codeWhat pi-cli-runtime does
pi-cli-runtime is an internal skill for the pi:pi-companion-forwarder subagent. It passes a request to Pi through pi-companion.mjs, invokes task once, then returns the command’s stdout unchanged. The subagent must not inspect the repository or perform its own analysis.
Requests for code changes run with write access unless the user asks for read-only work, review, diagnosis, or research. Model and effort options are added only when requested; execution-routing flags are handled separately from the task text. This skill is not user-invocable: it operates inside the named subagent. If Pi cannot be called, the subagent returns nothing.
What it helps with
- route a project diagnosis request to Pi
- send a research task through the Pi runtime
- delegate requested code changes to Pi
- resume a previous Pi run from its last point
Example prompts for the agent
- Ask
pi:pi-companion-forwarderto send Pi this task: find the cause of the failure and suggest a fix. - Route a research request through the forwarding subagent and return Pi’s response.
- Resume the previous Pi task and apply its leading fix.
How to install pi-cli-runtime
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a claude-code2Manually: put the files in place
~/.claude/skills/pi-cli-runtime/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pi-cli-runtime/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a codex2Manually: put the files in place
.agents/skills/pi-cli-runtime/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a cursor2Manually: put the files in place
.cursor/skills/pi-cli-runtime/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Agents365-ai/365-skills pi-cli-runtime2Manually: put the files in place
.github/skills/pi-cli-runtime/SKILL.md1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a gemini-cli2Platform CLI
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/pi-plugin-cc/skills/pi-cli-runtimeManually: put the files in place
.devin/skills/pi-cli-runtime/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pi-cli-runtime
How do I install pi-cli-runtime in Claude Code?
Run npx skills add Agents365-ai/365-skills --skill pi-cli-runtime -a claude-code. The skill is installed at ~/.claude/skills/pi-cli-runtime/SKILL.md.
What does pi-cli-runtime do?
It sets the handoff rules for pi:pi-companion-forwarder: make one task call to the Pi runtime and pass its stdout back unchanged.
Can I use it for read-only diagnosis?
Yes. A request limited to review, diagnosis, or research should run without write access. Requests for changes use a write-capable run by default.