scout
Skill2 starsChanged 41 days agoMITView on GitHub
Explore a problem you don't yet know how to handle — name what \"done\" actually looks like, fan out breadth-first across every open question between here and there, then settle them one at a time until the route is clear. Invoke with /scout when you have an idea or a problem but no plan yet and can't tell where to start. Output is a named destination plus the decisions that get you there — NOT code, and NOT a spec. Hands off to plan mode / validate-plan when the fog lifts. Runs in one session by default; escalates to /handover-save only if it genuinely outgrows one. Restraint-gated: \"you already know how to do this, go do it\" is a first-class result.
We split this skill into the rules it gives an agent
5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 39 edited versions we read keep these.
5
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 41
Facts you look up; decisions you ask: If something is checkable — the schema, the callers, the real data, the library's docs, what the code …
- Distinctive: line 61
After each answer, update the buckets:
- Distinctive: line 66
Don't pre-slice fog into fake questions to look productive.
- Distinctive: line 78
Default to one session, no artifact.
- Distinctive: line 118
Fog is not a backlog: Leave it loose. Pre-slicing it into tickets invents work that the next answer may delete.
“Common” is measured: kept by at least 6 in 10 of the 39 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
/scout — Where am I actually going, and how do I get there?
You have a problem or an idea, and the honest state is you don't know how to handle it. Not "which of three approaches" — you can't yet see the far end well enough to have three approaches. Everything else in this collection assumes a target already exists. This is the one that goes and finds it.
The job is to survey the terrain, then pick the route — not to charge at the destination, and not to start building the first thing that looks buildable.
What this is NOT — so you invoke the right thing:
- Not
grill-me— that interviews you about a plan you already have, walking one decision tree depth-first. This runs before a plan exists and deliberately goes breadth-first. When scout ends,grill-meis a reasonable next step. - Not
expand— that widens a product target with competitor research and new ideas. Scout calls it in pass 1b for product work, then narrows. - Not
explain— that maps code that already exists. This maps work that doesn't. - Not
root-cause— that's for a broken thing with a known symptom. Reach for that first if something is failing; scout the response to it afterwards, if the fix isn't obvious. - Not
validate-plan/ship-check— those judge a plan and a diff. Scout runs upstream of both and produces the thing they judge.
The restraint gate — read first. The failure mode is manufacturing a journey. If the opening pass shows you can already state the destination and the steps to it, say so and stop: "this doesn't need scouting — here's the plan, go." Most problems are like that. Ceremony on a clear path is pure cost. Likewise, if you reached for this skill rather than the user typing /scout, confirm before starting — an unrequested 20-question interview is a bad surprise.
The passes
1. Name the destination — before any other question
Ask what done looks like, and get it to one or two lines. It might be a decision locked, a spec to hand off, a migration completed in place, a feature working end to end. Different destinations produce completely different routes, so this is settled first and never assumed.
The destination fixes the scope — every question below is measured against it. If the user can't name it yet, that is the first thing to work on, and nothing else starts until it's named.
Check it against the hard rules before the fan-out. Read the project's non-negotiables (CLAUDE.md, a contract, a compliance constraint) and ask: if the work ends where those rules force it to end — including any fallback they prescribe — does that still count as done? If not, the destination is wrong. Say so and fix it with the user before anything else, rather than discovering it at the end. No conflict is the usual result; say it in one line and move on. (Found by /court on Agent Worlds #46: "done" required Allow/Deny to reach OpenCode, but the CLAUDE.md fallback is an informational card with neither.)
1b. Widen before you narrow — product work only
If the destination is something end users touch (a product, a feature, a screen), run expand before the fan-out: full mode for a new product or a milestone, light mode for a single feature. Scout's later passes cut scope hard; this is the one point where the target is deliberately widened — parity gaps the user didn't mention, friction killers, little touches, a level-changer. Approved ideas join the destination (re-state it); the rest go to Out of scope with a reason. Skip it for refactors, bug fixes, migrations and internal tooling.
2. Fan out — breadth-first, and resist answering
Sweep the whole space between here and the destination and collect the open questions. Do not resolve any of them yet. The pull to answer question one immediately is the thing this pass exists to defeat: the first question you notice is rarely the one that decides the shape, and answering it early means planning the wrong thing very carefully.
Go wide, not deep. Aim to surface the question you didn't know was there.
Facts you look up; decisions you ask. If something is checkable — the schema, the callers, the real data, the library's docs, what the code actually does today — go check it, don't spend a question on it. Only genuine decisions go to the user.
3. Sort into three buckets
| Bucket | Test | What you do |
| Sharp | You can state the question precisely right now | Work it (pass 4) |
| Foggy | You can feel a question is there but can't phrase it yet | One loose line, then leave it |
| Out of scope | It sits past the destination | Write it down; it doesn't come back |
The sharp/foggy test is whether you can state it, not whether you can answer it. A question with a hard or unknown answer is still sharp if you can phrase it exactly — those are often the most important ones.
Out of scope uses a different test — scope, not sharpness. Something can be perfectly sharp and still be out of scope because it's past the destination. Rule it out explicitly and say why; it only returns if the destination itself moves, and that's a fresh scout.
Then order the sharp questions by what unblocks the most — the answer that collapses the largest number of other questions goes first.
4. Settle them, one at a time
Ask one question at a time and wait. Give your recommended answer with each one — but it's a recommendation, and the decision is the user's. Never answer a decision on their behalf and never batch questions; a wall of five is bewildering and gets one lazy reply.
After each answer, update the buckets:
- Did it sharpen fog into a real, statable question? Promote it.
- Did it kill questions that no longer matter? Drop them.
- Did it move the destination? Say so loudly and re-check the other buckets against the new one — everything was measured against the old line.
Don't pre-slice fog into fake questions to look productive. Fog is a signpost, not a to-do list.
5. Stop when the route is clear
Done means: no sharp questions left, and what fog remains is genuinely deferrable or out of scope. Close with the destination, the decisions that got there, and the concrete next step.
Then hand off — don't build. Scout produces a route, not a deliverable. Go to plan mode (or /validate-plan if a plan came out of it), then implement. If you find yourself writing production code inside a scout, you've overrun the skill.
The one exception is a throwaway — when a question genuinely can't be settled on paper ("does this state model feel right", "what should this look like"), build the smallest rough thing that answers it, look at it, keep the answer and bin the code.
Crossing sessions — only if it actually needs to
Default to one session, no artifact. Most scouts fit, and a file written for a conversation that ended twenty minutes later is just litter.
Escalate to /handover-save when — and only when — one of these is true:
- the session is getting long enough that you'd lose the thread,
- the user wants to stop and pick it up later,
- a question is blocked on something outside the conversation (someone else's answer, access to provision, data to gather first).
The handover doc carries the destination and the three buckets. Resume with /handover-resume, which re-syncs drift before continuing. Spanning sessions is an escape hatch here, not the design.
Output shape
Show the map when it materially changes — after the destination is named, after the fan-out, and whenever an answer reshuffles the buckets. Not every turn.
## Scouting: <the idea, one line>
**Destination:** <what done looks like — everything below is measured against this>
**Decided**
- <question> → <the answer>
**Open — sharp**
1. <precisely-stated question> ← working this now
2. <...>
**Still foggy**
- <loose one-liner> — sharpens once <X> is settled
**Out of scope**
- <what was ruled out> — <why it's past the destination>Close with: destination, the decisions in order, and the single next step.
Guardrails
- Breadth before depth. Answering the first question before you've seen the whole space is the failure this skill exists to prevent.
- Look it up, don't ask it. A question you could have answered with a grep wastes the user's turn and their patience.
- One question, then wait. Recommend an answer every time; never decide for them.
- Sharpness ≠ answerability. The fog test is "can I state it," not "can I answer it."
- Fog is not a backlog. Leave it loose. Pre-slicing it into tickets invents work that the next answer may delete.
- Out of scope is a scope call, not a step. It goes in its own bucket, never into the decisions list.
- The destination can move — announce it when it does. Silently re-aiming invalidates every judgment made before it.
- Don't build. Decisions out, not deliverables. Throwaway prototypes are the only exception.
- No file by default.
/handover-saveonly when the work genuinely outgrows the session. - Restraint gate. "There's no fog here — you already know how to do this" is a real, valuable result. Never invent open questions to justify running the skill.
Destination-first framing, the breadth-first fan-out, the state-it-vs-answer-it fog test, and the scope-vs-sharpness split adapted from Matt Pocock's wayfinder (github.com/mattpocock/skills). Its issue-tracker map, child-ticket machinery, and one-ticket-per-session rule are deliberately dropped — this collection persists across sessions with /handover-save instead.
Other versions43 projects use a version of this.
Word for word · 1
- AhmedMerza/claude-skills★ 2100% same
Edited · 0
None found.
Wrote their own version · 42
- huytieu/COG-second-brain★ 1.3ksame name
- HazAT/pi-config★ 451same name
- OneWave-AI/claude-skills★ 378same name
- typv/nest-turbo-starter★ 224same name
- QinghongLin/data2story-skill★ 155same name
- andrew-yangy/gru-ai★ 153same name
- simota/agent-skills★ 96same name
- vaayne/agent-kit★ 53same name
- anton-abyzov/vskill★ 48same name
- baekenough/oh-my-customcode★ 42same name
32 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.
Used alongsideProjects with it also use blueprint, feature and 5 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.
WordPressSkillblueprint
Use when the deliverable is WordPress Playground Blueprint JSON or a Blueprint bundle, including creating, editing, reviewing, validating schema keys, choosing steps/resources, and debugging Blueprint files. For only running or sharing a Playground environment, use wp-playground.
Also in 3 projects that use this
bradtraversySkillfeature
Manage current feature workflow - start, review, explain or complete
Also in 3 projects that use this
HK-hubSkilldistill
Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. Use when the user asks to simplify, declutter, reduce noise, remove elements, or make a UI cleaner and more focused.
Also in 3 projects that use this
Microsoft AzureSkilltest
Also in 4 projects that use this
NVIDIASkillresearch
Before designing a feature, research how comparable libraries solve the problem, check best practices, known pitfalls, and upstream changes. Use when starting a new feature, investigating an unfamiliar area, or the user asks to research something.
Also in 6 projects that use this
Harut8Skillarchitect
Also in 3 projects that use this
In this repository53 other files it gives its agents.
- animateSkill
- api-docs-completeSkill
- best-optionSkill
- browseSkill
- changelog-generateSkill
- checkpointSkill
- claimSkill
- commitSkill
- courtSkill
- design-driftSkill
- designSkill
- expandSkill
- explainSkill
- fix-reviewSkill
- grill-meSkill
- handover-listSkill
- handover-resumeSkill
- handover-saveSkill
- i18n-syncSkill
- issueSkill
- leadSkill
- mr-approveSkill
- mr-assignSkill
- mr-createSkill
- mr-guideSkill
- mr-listSkill
- mr-mergeSkill
- mr-review-requestSkill
- mr-reviewSkill
- mr-statusSkill
- persona-walkthroughSkill
- ponytailSkill
- prove-the-testSkill
- qa-crawlSkill
- qa-sweepSkill
- reflectSkill
- reviewSkill
- root-causeSkill
- second-opinionSkill
- ship-checkSkill
- skill-auditSkill
- skill-compareSkill
- spinoffSkill
- story-siteSkill
- tool-compareSkill
- ui-auditSkill
- ui-polishSkill
- usage-weekSkill
- ux-auditSkill
- validate-planSkill
- video-teardownSkill
- wait-whatSkill
- where-were-weSkill
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.

