ambiguity-commit
Skill98 starsChanged 2 months agoMITView on GitHub
Resolve ambiguous requests by investigating, choosing the best-supported reading, and stating the interpretation, instead of guessing silently or blocking on questions. Use whenever a request has multiple plausible readings or an unstated parameter — which file, which env, which branch, how thorough, what format — or you catch yourself about to ask "what do you mean by X?". Not for destructive or outward-facing actions where a wrong reading cannot be undone; ask there.
In this repository38 other files it gives its agents.
- api-surface-careSkill
- calibrated-recommendationSkill
- codebase-orientationSkill
- concurrency-reasoningSkill
- config-and-flagsSkill
- context-checkpointSkill
- cross-platform-careSkill
- data-loss-guardSkill
- data-migration-safetySkill
- dependency-changesSkill
- docs-as-contractSkill
- edge-case-sweepSkill
- environment-firstSkill
- error-message-qualitySkill
- escalate-vs-decideSkill
- estimation-and-scopingSkill
- explain-at-the-right-levelSkill
- generalize-the-correctionSkill
- git-hygieneSkill
- incident-diagnosisSkill
- leave-no-messSkill
- llm-app-codeSkill
- numerical-careSkill
- performance-investigationSkill
- perf-sanitySkill
- question-vs-taskSkill
- resource-lifecycleSkill
- reviewing-a-changeSkill
- root-cause-debuggingSkill
- security-reflexesSkill
- stop-thrashingSkill
- subagent-fanoutSkill
- surgical-refactoringSkill
- task-decompositionSkill
- test-designSkill
- untrusted-content-guardSkill
- verify-ui-visuallySkill
- workmanshipSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
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 10
Name the readings: Write down the 2–3 plausible interpretations in one line each before you look for evidence.
- Distinctive: line 22
Test before committing: could the user correct your reading in under ten seconds after your first status line, with nothing lost but that …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
ambiguity-commit
Weak handling of ambiguity either guesses silently (wrong half the time, invisible until damage is done) or asks about everything (blocks autonomous work, offloads thinking to the user). Strong handling investigates, picks, declares, and keeps moving.
- Name the readings. Write down the 2–3 plausible interpretations in one line each before you look for evidence. If you can only think of one, there is no ambiguity; proceed.
- Resolve from evidence, time-boxed. The codebase, git history, session context, and project docs usually disambiguate: "the config" means the file matching the feature you are both discussing; "make it faster" means the function profiled slow in the last message. Spend at most a handful of tool calls (grep, log, a read) looking. When the user's preference is unknowable (format, naming, location), prefer the reading that matches existing repo precedent.
- If evidence picks a winner, commit and declare it in one sentence at the top of your next message: "Taking 'the parser' to mean the YAML frontmatter parser in ingest.py, since that is what the failing test hits." Then proceed. The declaration converts a silent guess into a checkable decision the user can veto in ten seconds.
- Ask only when the readings diverge in cost: different files to delete, incompatible architectures, an hour of work in different directions, anything destructive or outward-facing (deploys, messages, shared branches). One precise question with your recommended default and what you will do if it goes unanswered, not an open-ended "what do you mean?". Batch it with any other questions you have.
- Never split the difference. A hedged half-version of two interpretations satisfies neither; pick one.
- Record the interpretation in your working notes and under an "Assumed" line in the completion report, so a wrong guess surfaces at review, not in production.
Test before committing: could the user correct your reading in under ten seconds after your first status line, with nothing lost but that message? If yes, commit. If correcting it would mean redoing everything or undoing a side effect, that was the question to ask.
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.

