pi-prompting — Claude Code skill: what it does, how to install
Internal prompt guidance for Pi task runners using DeepSeek models. It helps structure coding, debugging, and repository review through strict XML contracts.
npx skills add Agents365-ai/365-skills --skill pi-prompting -a claude-codeWhat pi-prompting does
This skill guides pi:pi-companion-forwarder when it delegates work to Pi. By default, the plugin targets DeepSeek V4 models: Flash for general work and Pro for code reviews. Instead of loose instructions, prompts are organized into explicit XML blocks like <task>, <output_contract>, and <action_safety>. Numbered checklists take priority over plain paragraphs.
For coding and debugging, prompts include a <completeness_contract> requiring passing tests and clean lint runs. When pi-subagents is present, it adds an <available_pi_subagents> block to route tasks between workers, planners, and scouts. Built-in tools like /pi:review and /pi:adversarial-review already carry predefined review instructions, so manual prompt drafting is unnecessary for those tasks.
Raising reasoning with --effort high by default is counterproductive. DeepSeek Flash gets no benefit from it, while DeepSeek Pro takes longer to answer. Tightening the prompt checklist works better.
What it helps with
- structure Pi prompts with
<task>and<action_safety>XML tags - restrict writable directories and files during automated edits
- enforce definition-of-done criteria with tests and linter checks
- route subtasks across specialized workers with
pi-subagents
Example prompts for the agent
- Draft a task prompt for Pi to fix a bug in
src/auth.tsfollowing pi-prompting rules - Prepare a prompt for Pi with an
<action_safety>block for safe refactoring - Compose a follow-up instruction for
task --resume-lastwith only the delta
How to install pi-prompting
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-prompting -a claude-code2Manually: put the files in place
~/.claude/skills/pi-prompting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pi-prompting/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-prompting -a codex2Manually: put the files in place
.agents/skills/pi-prompting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-prompting -a cursor2Manually: put the files in place
.cursor/skills/pi-prompting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Agents365-ai/365-skills pi-prompting2Manually: put the files in place
.github/skills/pi-prompting/SKILL.md1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-prompting -a gemini-cli2Platform CLI
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/pi-plugin-cc/skills/pi-promptingManually: put the files in place
.devin/skills/pi-prompting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill pi-prompting -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-prompting
How to install pi-prompting in Claude Code?
Run npx skills add Agents365-ai/365-skills --skill pi-prompting -a claude-code.
What does pi-prompting do?
It outlines prompt formatting rules for Pi task runners on DeepSeek Flash and Pro. The skill structures tasks using XML contracts that define task scope, safe file paths, and output criteria.
Can pi-prompting be invoked directly by a user?
No, the skill is set to user-invocable: false. It acts as internal guidance and is triggered when pi:pi-companion-forwarder dispatches tasks to Pi.
