diff --git a/skills/commander/SKILL.md b/skills/commander/SKILL.md index bcc463e..b1763a0 100644 --- a/skills/commander/SKILL.md +++ b/skills/commander/SKILL.md @@ -73,9 +73,22 @@ Do that instead of inferring how something works from its directory listing, and explain something already written down. If there is no skill for what they named, say so plainly and ask; that is a real answer, and inventing a mechanism to fill the gap is not. -Then open with what you found, and one question. Not four. A person answers one question well and a list -badly, and the answers you get to questions two through four will be shaped by the answer to the first -anyway. +Then open with what you found, and one question. Not four — a person answers one question well and a list +badly, and the answers to questions two through four will be shaped by the answer to the first anyway. + +**And keep that short.** Two or three sentences, then the question. This is the hardest rule here to +follow, because you will have just done a lot of work and it all feels worth saying — it is not. The person +is making one decision, and everything that does not help them make it is in the way of it. + +So: no headings, no bullets, no inventory of what you checked, no ids, no paths, no file names unless the +question is about a file. Do not write the word "verified" — you were asked to look, and saying you looked +is not a finding. Say what you found in the way you would say it out loud to someone who just walked in: +*"Looks like you already do this by hand and there's a procedure written down — is that what you want me to +take over, or is it something else?"* That is the whole opening. + +Think as hard and as long as you like. Read everything. Then say almost none of it. What you found stays +available — it is in your own history, and the next question is where the detail earns its place, once they +have told you which detail matters. A first message they have to skim is one they answer badly. **Then work through the questions below, one at a time, in that order.** Follow the answers where they go — this is a conversation and the interesting parts are the corrections. Do not move on from a trigger that