diff --git a/skills/invoking-subagents/SKILL.md b/skills/invoking-subagents/SKILL.md index ddb6b5f5140829159b68090b15f527dbb2925ec8..a66caf99f4762b7f4894c5e768c4a036828b3915 100644 --- a/skills/invoking-subagents/SKILL.md +++ b/skills/invoking-subagents/SKILL.md @@ -9,9 +9,13 @@ metadata: Invoke with `PI_PERMISSION_LEVEL=level pi -p 'prompt'`. DO NOT impose a timeout. Set a different model, if requested, with `pi --model "provider/model" -p "prompt"`. -**Important:** Subagents are scoped to their cwd. To invoke a subagent in another folder, `cd there && PI_PERMISSION_LEVEL=level pi ...`. +**Important:** Subagents are scoped to their cwd. To invoke a subagent in another folder, `cd there && PI_PERMISSION_LEVEL=level pi ...`. Subagents are also amnesic _unless_ you follow up with `-c`. If you're coordinating between multiple subagents in the same directory, or there might be multiple working in the same directory that you're not controlling, `-c` might instead continue _their_ conversation. In those cases, specify which pi `--session ` you want to continue. -Use a precise and thorough prompt. You may invoke multiple when appropriate and in parallel if helpful. Once they're running, you may either stop and wait for me to tell you they're finished or continue with other work. Aggressively restrict their permissions: +Craft a precise and thorough prompt. Generally assume the model is intelligent and capable; don't prescribe too much of a process and instead prefer to give it all background, constraints, and goals. However, the user might compare the model to one of opus, sonnet, or haiku. If compared to sonnet, do prescribe a _bit_ more process through leading, socratic questions. If compared to haiku, however, you _ARE_ its planner and must prescribe the _ENTIRE_ process. Haiku-equivalent models are fast, light, and cheap, but only effective if directed well. If directed poorly, they make a mess that's much harder to clean up. + +You may invoke multiple subagents when appropriate and in parallel if helpful, using e.g. backgrounded commands or tmux. Once they're running, you may either stop and wait for me to tell you they're finished or continue with other work. + +Aggressively restrict their permissions: - minimal: read-only commands such as ls, cat, git status, etc. - low: + write/edit files