Agent skill · agents365-ai
pi-prompting
Internal guidance for composing prompts that Pi runs (DeepSeek by default) handle reliably for coding, review, diagnosis, and research tasks
What it needs
About 2k tokens when loaded.
What this skill does
Pi Prompting Use this skill when pi:pi-companion-forwarder needs to ask Pi for help on a non-trivial coding or investigation task. Pi runs whatever model the user has configured. By default this plugin targets DeepSeek V4 (Pro for review, Flash for everyday tasks). The guidance below assumes the prompt may run on either a non-reasoning model (Flash) or a reasoning model (Pro). Bias toward concrete, numbered checklists rather than abstract instructions — both model classes follow those reliably. Core rules: Prefer one clear task per Pi run. Split unrelated asks into separate runs. Tell Pi what done looks like. Do not assume it will infer the desired end state. State explicit grounding rules whenever an unsupported guess would degrade quality. Use stable XML-style tag blocks so the prompt has obvious internal structure. Keep prose short. Prefer numbered checklists over paragraphs for procedural work. Default prompt recipe: <task>: the concrete job and the relevant repository or failure context. Include file paths. <outputcontract> (or <structuredoutputcontract> for JSON): exact shape, ordering, and brevity requirements. <groundingrules>: required for review, research, or anything that could drift into unsupported claims. <actionsafety>: required for write-capable tasks — name the directories and file kinds Pi may touch. When to add extra blocks: Coding or debugging: add <completenesscontract> listing what counts as "done" (tests pass, lint clean, files touched). Review or adversarial review: rely on the shipped prompts/adversarial-review.md and prompts/review.md. Do not hand-craft another review prompt. Research or recommendation tasks: add a short <sources> block listing what Pi is allowed to consult. How to choose prompt shape: Use the built-in /pi:review or /pi:adversarial-review commands when the job is reviewing local git changes. Those prompts already carry the review contract. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills agents365-ai/pi-prompting--78d7a6