Disambiguate

Rewrite a requirement so it can only be read one way. Distilled from ASD-STE100 Simplified Technical English — forty years of aerospace evidence about what a reader misreads when they cannot ask the author what he meant. Turns a vague ask ("handle errors gracefully", "the system should support X") into something atomic, owned, bounded, and testable, and says which of five reader-questions each defect leaves open. Ships a deterministic checker (scripts/disambiguate.py, stdlib only) that catches the mechanical ambiguity — agentless passive, noun stacks, weak modals, unquantified deltas, compound obligations, over-length sentences, condition-after-action, synonym drift — so judgment goes to the parts that need it. USE WHEN: sharpening a requirement, acceptance criterion, ticket, spec line, PRD, API contract, error message, runbook step, or agent prompt. Also when a review comment says "unclear" or "what does this mean", when two people read the same line differently, and when writing instructions for someone who cannot ask a follow-up question. Triggers on "disambiguate", "improve this requirement", "tighten this spec", "make this unambiguous", "is this clear", "rewrite this ticket", "sharpen this AC", "review this requirement", "simplified technical english", "STE", "controlled language". NOT FOR: prose style or tone editing (this makes text precise, not pleasant), formatting a design doc (use make-spec), or deciding *what* to build (this sharpens a decision already made, it does not make it).

mkdir -p ~/.claude/skills/disambiguate
curl -L https://claudskills.com/skills/disambiguate/SKILL.md \
  -o ~/.claude/skills/disambiguate/SKILL.md

@misc{disambiguate-2026,
  author    = {broomva},
  title     = {Disambiguate [Claude Code skill]},
  year      = {2026},
  publisher = {ClaudSkills},
  url       = {https://claudskills.com/skills/disambiguate/}
}