readchk
Installation
SKILL.md
Check the read before acting: did you understand the instruction correctly enough to spend the work?
Goal
readchk catches misread instructions before they become coherent work against the wrong target. It verifies a claim about the requester's intent against available context: the current message, session history, project memory, files on disk, and established conventions.
This is not factchk: the question is what was meant, not whether a world claim is true.
Workflow
- Recognize the signal: a long or multi-part instruction, ambiguous scope or referents, deliberately flexible wording, or stakes high enough that a wrong guess would cost real work.
- Restate the instruction internally in different words. Do not copy the user's wording back to yourself and treat that as understanding.
- Cross-check the restatement against available context. Look for contradictions, missing antecedents, or two plausible readings that context cannot choose between.
- If context resolves the read, proceed silently. Do not ask the requester to confirm what the available context already answered.
- If a real fork survives, surface one specific clarifying question anchored to the restated understanding. Name the choice; do not ask a vague "does this look right?"
- For substantial work, log one durable "understood as: ..." line before beginning so a later reader can audit whether the work matched the confirmed read.