deep-plan
Skill1 starsChanged 6 months agoMITView on GitHub
Delegate the PLANNING step of a complex task to an Opus sub-agent while the main (cheaper) model handles execution. Useful when the main conversation runs on Sonnet or Haiku but the task needs Opus-quality reasoning to plan well. Slash trigger: /deep-plan. Natural-language triggers at start of message: 'plan this carefully', 'think hard first', 'plan first then execute', 'use opus to plan', 'deep plan', 'deep-plan'. Do NOT use for simple lookups, arithmetic, or single-step tasks — the sub-agent overhead isn't worth it.
16 other projects use a version of this.
Adopted by
Most recently taken up by
- ryanportfolio/HarnessFirmware.comtheir own version, first seen Nov 8, 2026
- ryanportfolio/winuse-mcptheir own version, first seen Nov 8, 2026
- ryanportfolio/Harness-Firmwaretheir own version, first seen Nov 7, 2026
- ryanportfolio/Corewise.Academytheir own version, first seen Nov 1, 2026
- oguzsabi/deep-skillstheir own version, first seen Nov 1, 2026
- ryanportfolio/STKtheir own version, first seen Oct 20, 2026
Used with
Projects with it also use addskill, apply-firmware and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ryanportfolioSkilladdskill
Create, import, update, or install repo or personal skills: runtime ownership, resources, discovery checks.
Also in 6 projects that use this
ryanportfolioSkillapply-firmware
Bring current folder (plain folder, existing repo, old or partial firmware copy) up to full Harness Firmware in place. Mirror external repo → adopt-repo.
Also in 6 projects that use this
- +10 more from ryanportfolio
Other versions16 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 16
- piercelamb/deep-plan★ 104same name
- baekenough/oh-my-customcode★ 42same name
- phj128/autoworker★ 18same name
- npow/claude-skills★ 4same name
- Deep-Process/deep-process★ 2same name
- jasonmichaelbell78-creator/sonash-v0★ 2same name
- ryanportfolio/winuse-mcp★ 2same name
- oguzsabi/deep-skills★ 1same name
- ryanportfolio/Corewise.Academy★ 1same name
- ryanportfolio/Harness-Firmware★ 1same name
6 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- terse-modeSkill
- verify-handoffSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 8 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 15 edited versions we read keep these.
8
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Use when all of these hold:
- Distinctive: line 17
Do not use for: simple lookups, syntax questions, arithmetic, single-step tasks, things the main model handles fine on its own.
- Distinctive: line 21
Confirm the task is worth the overhead: If it's clearly trivial, tell the user this skill isn't worth it for this request and just answer …
- Distinctive: line 25
Invoke the Plan sub-agent with model override: Use the Agent/Task tool with:
- Distinctive: line 39
When invoking the sub-agent, use this shape:
- Distinctive: line 74
Delegating trivial work: If the task is simple, skip the sub-agent and answer directly.
- Distinctive: line 78
Re-delegating mid-execution: If a new sub-problem arises during execution, handle it in the main model unless it's genuinely another …
- Distinctive: line 95
Run arbitrary tools in the sub-agent.
“Common” is measured: kept by at least 6 in 10 of the 15 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Deep Plan
Delegate the hard thinking (planning, architecture, trade-off analysis) to an Opus sub-agent, then execute the plan in the main model. Optimizes for cost when the main conversation is running on a cheaper model but the task genuinely benefits from Opus-level reasoning for planning.
When this is worth using
Use when all of these hold:
- The task has real complexity (multi-step, judgment calls, non-obvious trade-offs).
- The main conversation is on Sonnet or Haiku (not Opus — if the main model is already Opus, this skill doesn't save money).
- Errors would be expensive to undo (stakeholder deliverable, production code, payroll numbers).
Do not use for: simple lookups, syntax questions, arithmetic, single-step tasks, things the main model handles fine on its own. Sub-agent overhead would cost more than it saves.
Flow
- Confirm the task is worth the overhead. If it's clearly trivial, tell the user this skill isn't worth it for this request and just answer directly. Don't auto-delegate everything.
- Extract the full task context. Pull the user's actual request, any relevant files, constraints, prior conversation context — everything the sub-agent needs to plan well. The sub-agent starts fresh, so the prompt must be self-contained.
- Invoke the Plan sub-agent with model override. Use the Agent/Task tool with:
subagent_type: "Plan"model: "opus"description: short summary of what to plan (3–5 words)prompt: full self-contained brief — goal, context, constraints, expected plan format. End with "Return a step-by-step plan with file paths, decisions, and risk flags. Do not execute."
- Receive the plan. The sub-agent returns a structured plan.
- Surface the plan to the user for review. Show the plan as-is (or lightly reformatted for readability). Ask one question: "Run this as-is, or want to tweak?" Let the user edit or approve.
- Execute the plan in the main model. Once approved, step through the plan using the main model's regular tools. Do not re-invoke the sub-agent for execution — that defeats the cost savings.
Prompt template for the Plan sub-agent
When invoking the sub-agent, use this shape:
Task: {one-sentence goal}
Context:
- {file paths, system, relevant state}
- {prior conversation points that matter}
- {user preferences or conventions already established}
Constraints:
- {what must NOT change}
- {formatting, output, tools to use}
- {things that have bitten past attempts, if known}
Required plan shape:
- Step-by-step with file paths and tool calls where relevant
- Flag architectural decisions and trade-offs explicitly
- Call out risks and what could go wrong
- Do NOT execute. Return the plan only.
Output format: numbered steps, one action per step.Cost reminder
Sub-agent tokens are billed at the sub-agent's model rate. So if the main conversation is on Sonnet and planning is delegated to Opus:
- Planning cost = Opus rate × planning tokens (small)
- Execution cost = Sonnet rate × execution tokens (usually large)
- Net: much cheaper than running the entire task on Opus.
If the main conversation is already on Opus, this skill adds overhead without saving money — the main model can plan just as well inline. Tell the user that when they trigger it on Opus, and ask whether they want to proceed anyway (for context-isolation benefits) or skip delegation.
Pitfalls
- Delegating trivial work. If the task is simple, skip the sub-agent and answer directly. This skill should be conservative about firing.
- Under-briefing the sub-agent. It has no memory of this conversation. If you forget to include a constraint, the plan will miss it. Err toward over-including context in the prompt.
- Executing in the sub-agent. The sub-agent plans only. If you let it execute, you're paying Opus rates for the whole task — the opposite of the goal.
- Skipping user review of the plan. The user should see the plan before you execute it. Planning is the step most likely to go sideways; catching it before execution is much cheaper than catching it after.
- Re-delegating mid-execution. If a new sub-problem arises during execution, handle it in the main model unless it's genuinely another deep-plan moment. Don't death-spiral into nested sub-agents.
Example
User: /deep-plan refresh the P5 carwash deck from the new source workbook and make sure every number ties
What to do:
- Confirm this is worth delegation — yes, multi-step, stakeholder deliverable, numbers have to tie.
- Build the sub-agent prompt including: period number, deck path, source workbook path, reference to the carwash-deck-refresh skill, the user's "don't overwrite manual edits" preference, the validation-pass requirement.
- Invoke Agent with
subagent_type: "Plan",model: "opus". - Get back a 6–10 step plan (read workbook, update KPIs, update tables, rename Mid-Period → Period End, validation pass, report changes, etc.).
- Show plan to user: "Here's Opus's plan — run as-is, or adjust?"
- On approval, execute in the main (cheaper) model using the actual pptx/xlsx tools.
What this skill does not do
- Switch the main conversation's model. Only invokes sub-agents with a model override.
- Run arbitrary tools in the sub-agent. Sub-agent is planning-only.
- Apply to conversational or trivial questions — those should just get answered directly.
- Chain multiple sub-agents for the same task. One plan, one execution.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

