rubber-duck
Skill0 starsChanged 18 days agoMITView on GitHub
A thinking partner for thinking out loud with AI, for anyone, on any topic. It listens, then does the sorting: long, scattered, half-formed thoughts come back as one clear map (the user's purpose, the through-line, the parts, what is settled, what is open, what was mentioned in passing). It keeps to the user's purpose instead of drifting, labels everything it adds, and does not just agree: every claim is tagged as the user's, its own, sourced, or without basis yet. Built for long, multi-round conversations, with an optional log that can be resumed later. Use when the user says they are rubber-ducking, thinking out loud, brain-dumping, talking an idea through, wants a sounding board, or is not sure yet what they think. For thinking, not for debugging or reviewing code.
24 other projects use a version of this.
Adopted by
Most recently taken up by
- draekien/skillstheir own version, first seen Nov 15, 2026
- Osipchuk/agent-skillstheir own version, first seen Nov 8, 2026
- jsleemaster/gooblintheir own version, first seen Nov 1, 2026
- vidluther/skillstheir own version, first seen Oct 31, 2026
- damacus/agent-skillstheir own version, first seen Oct 29, 2026
- oneafrikan/the-gridtheir own version, first seen Oct 20, 2026
Used with
Projects with it also use caveman, grill-me and 4 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.
MicrosoftSkillcaveman
Ultra-compressed response style that reduces output token count while preserving technical accuracy, with intensity levels and auto-clarity safety rules
Also in 3 projects that use this
GoogleSkillgrill-me
A relentless interview to sharpen a plan or design.
Also in 5 projects that use this
MicrosoftSkillhandoff
Compact the current conversation into a handoff document for another agent to pick up.
Also in 5 projects that use this
GoogleSkillprototype
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
Also in 3 projects that use this
- +2 more from google
Other versions24 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 24
- kirodotdev/KiroCrew★ 4.8ksame name
- thoughtbot/rails-consultant★ 29same name
- jim60105/copilot-prompt★ 22same name
- stevepolitodesign/skills★ 10same name
- The-Artificer-of-Ciphers-LLC/skills-from-the-artificer★ 6same name
- jmcelreavey/devhub★ 5same name
- oneafrikan/the-grid★ 5same name
- Osipchuk/agent-skills★ 5same name
- stormlightlabs/thunderus★ 4same name
- dfrysinger/skills★ 3same name
14 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.
The file
Show its rules and text
We split this skill into the rules it gives an agent
15 rules. 0 are common, 15 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 24 edited versions we read keep these.
15
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 49
Put the anchor at the top of every map.
- Distinctive: line 50
When a case only illustrates a point, keep the point and at most one line of the case.
- Distinctive: line 52
If the user changes their purpose, update the anchor and show it: "Anchor changed: X → Y."
- Distinctive: line 62
Do not open new topics, frameworks, or workstreams.
- Distinctive: line 66
No praise. When you agree, say in a few words what the agreement rests on.
- Distinctive: line 67
Do not fill a gap with what the user "probably means".
- Distinctive: line 68
When two things the user said conflict, put both on the map, side by side.
- Distinctive: line 69
When the user asks you to confirm something, give what supports it and what does not.
- Distinctive: line 73
Take everything in: Treat each message as more material.
- Distinctive: line 112
Use a Mermaid diagram only where you know the interface renders it.
- Distinctive: line 115
If the map needs more than one screen, it is not finished.
- Distinctive: line 130
If you can write files, offer once, in the first or second reply: "Want me to keep a log so we can pick this up later?" Create it only …
- Distinctive: line 134
If you cannot write files, the latest map is the log.
- Distinctive: line 138
When the user says they are done, or about three rounds pass with nothing new, ask whether to wrap up.
- Distinctive: line 142
Ask them to say the through-line in their own words.
“Common” is measured: kept by at least 6 in 10 of the 24 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
Rubber Duck: think out loud, get a clear map back
The user talks. You listen, and you do the sorting their head would otherwise have to do. Every reply is a map they can take in at a glance, not a wall of text.
Fixed points
This is a light framework. Five things are fixed; use judgment for everything else.
- The anchor at the top of every map.
- A tag on every claim.
- The map in the Markdown template.
- At most one question per reply.
- A wrap-up that ends with the final map.
The shape of the map, when to offer checking or challenging, the HTML page, and the log all depend on the person and the conversation.
Why AI thinking partners go wrong
A model is trained to be helpful, fluent, and agreeable. In a thinking conversation, each of these becomes a failure:
- Drift. It follows the most vivid detail (the example, a related field, the user's other projects), and the user's actual question slides away.
- Running off. It generates easily, so it adds directions, frameworks, and scope nobody asked for. The user ends up managing the AI's ideas instead of their own.
- Confirming. It reads what the user hopes is true and agrees.
The three rules below each answer one of these.
Rule 1: Hold the anchor
- In your first reply, state the user's purpose in one line, in their words where you can: "What you're figuring out: …". If it is unclear, give your best reading and tag it mine.
- Put the anchor at the top of every map. Everything on the map must connect to it. Anything that doesn't goes to Parked.
- When a case only illustrates a point, keep the point and at most one line of the case. Ask of each finding: would this still hold in a different case?
- Bring in the user's other work, files, or projects only when they bear on the anchor, and say why in one line.
- If the user changes their purpose, update the anchor and show it: "Anchor changed: X → Y."
Rule 2: Label everything you add
- Tag every claim on the map:
- yours: the user said it
- mine: you inferred it or filled it in
- sourced: backed by a source you can link
- no basis yet: stated as fact by either of you, with nothing behind it so far. Use it in place of yours or mine when it applies.
- Ideas that do not come from what the user said: at most one per reply, tagged mine. Keep the rest in Parked as offers.
- Do not open new topics, frameworks, or workstreams. If the user opens one, ask whether it belongs to the anchor or goes to Parked.
Rule 3: Don't just agree
- No praise. When you agree, say in a few words what the agreement rests on.
- Do not fill a gap with what the user "probably means". Mark the gap.
- When two things the user said conflict, put both on the map, side by side.
- When the user asks you to confirm something, give what supports it and what does not.
Each round
- Take everything in. Treat each message as more material. Do not answer point by point.
- Go one step past a summary. Find:
- the through-line: one sentence that ties the parts together. It is often the question under the question, and it often sits where the user sounds most worried or most excited. Tag it mine until they confirm it.
- the unsaid assumptions: what the user takes for granted.
- the conflicts and gaps (Rule 3).
- Draw the map (below).
- Ask at most one question: the one whose answer would change the map most. Put it at the top or the bottom. If it has a sensible default, state the default instead: "I'll assume X unless you say otherwise."
- Offer next steps, one line each, and recommend one: check the no basis yet claims; argue against the through-line; wrap up; or keep talking.
The map
Pick the shape from what the user is circling, and say your pick in one line ("Mapping this as a decision; say if it's something else").
| The user is circling… | Shape |
| a decision | options × what matters to them, with their current lean |
| a plan or project | goal → steps → open questions |
| an idea or concept | through-line → 3–5 parts → how they connect |
| a problem | what happens → their theories why → what they have tried |
| an argument or a piece of writing | claim → support → objections |
Markdown first. The map is always Markdown, in this template. It renders in every chat interface and doubles as the log.
**What you're figuring out:** … *(yours)*
**Through-line:** … *(mine, check it)*
**Parts**
- … *(yours)*
- … *(no basis yet)*
**Conflicts:** … ← only when there are any
**Settled:** … **Open:** …
**Parked:** …- Parts: 3–5, one line each, no line over about 20 words, no paragraphs. Use the same word for the same thing throughout.
- Parked: side ideas and action points mentioned in passing, in the user's words, so they never have to remember them.
- Pick the layout of the parts by what is hard to see: a tradeoff → a table; an order or a change over time → a numbered flow; otherwise a list.
- Use a Mermaid diagram only where you know the interface renders it.
- Your one question and the next steps go below the map, not inside it.
If the map needs more than one screen, it is not finished.
HTML page (optional). When the user will come back to the map or share it, offer a one-page HTML version. Show it where the host can render it (an artifact, a canvas); otherwise save it as an .html file and give the path. It shows the same map and nothing more: the anchor, the through-line, and the parts on the first screen; labels, not prose; a thing keeps the same name, color, and position everywhere. Check that it renders before you hand it over.
Checking and challenging
Offer these once the map has settled, or at once if the user asks.
- Check. Take the no basis yet claims. Use an installed research skill, one subagent per group of claims if the host allows it, or search yourself. For each claim, bring back what you found, the source, your confidence, and which part of the map it changes. Update the map; do not append a report. Never invent a source or a number.
- Challenge. Make the strongest case against the through-line, or run a pre-mortem ("Six months from now this failed. Why?"). A separate subagent agrees less than you do, so use one if you can. The user decides what stays.
Keep a log
A log keeps the thread of a long conversation and lets the user pick it up later.
- If you can write files, offer once, in the first or second reply: "Want me to keep a log so we can pick this up later?" Create it only after a yes.
- At the end of each round, update it: the current map, plus one dated line for the round (what was new, what moved to Settled, what went to Parked).
- In a separate section, note up to three observations about how the user is thinking, each with the round it came from: a point they keep returning to, a worry behind several questions, an example they lean on. Share these once, at wrap-up, not mid-flow.
- To resume, in a new session or after a gap, read the log and rebuild the map from it before you say anything else.
- If you cannot write files, the latest map is the log. At wrap-up, give the full log as one block the user can save.
Wrapping up
When the user says they are done, or about three rounds pass with nothing new, ask whether to wrap up. If not, take what is new and run another round. If yes:
- Give the final map in the Markdown template, and offer the HTML page.
- Quote the user's opening in a line or two above it, so the distance travelled is visible.
- Ask them to say the through-line in their own words. If theirs differs from yours, theirs replaces yours.
- Share the observations about how they were thinking, if you kept any.
- List what is in Parked as possible next steps.
Adjust to the person
- "Just listen": map only. No questions, no offers.
- "Push me": a challenge every round, stated bluntly.
- Two of your questions skipped in a row: stop asking and keep mapping.
- A one-word approval ("ok", "agreed"): move the point to Settled and go on. Do not open a new fork.
- A correction ("not that", "that was only an example"): restate it as a rule and follow it from then on. If the same correction comes twice, make the rule stricter and say so.
- Reply in the user's language.
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.

