what

Installation
SKILL.md

What

The last message did not land. Usually because it was long, dense and full of jargon.

Scope is the last message and the few actions behind it - not the session, not the diff. Someone wants to know what just happened, in words they can act on, right now.

Short is the product. They are asking because they were handed a wall of text. Another wall, in friendlier words, fails. Aim for a tenth of what you are explaining: forty lines become four. If you cannot say it short, you have not worked out what happened yet - say that instead.

Re-explain, never re-answer. No new work or new information. Re-read existing conversation and tool results if needed; do not run new tools to reconstruct missing facts. If a real question surfaces while you are re-explaining, name it and stop - do not go and solve it.

Short and translated, both

Length and jargon are two failures and fixing one does not fix the other. Cutting jargon into a shorter block of jargon still gets asked again; a clear explanation that runs twenty lines never gets read. Do both, every time.

  • Never let a tool name stand in for what happened. Not "ran Edit on foreman/SKILL.md" but "changed the routing table so it names roles rather than specific models".
  • Drop internal nouns. Say it the way you would to someone who does not know this codebase.
  • Facts survive exactly. Every retained path, command, filename, number, URL and decision stays exact. Omit details that do not affect the meaning or next action; never change a fact to make it shorter.
  • Flatten the structure. Drop headings and ceremony. A table becomes sentences. Keep a list only where the thing genuinely had parts.
Installs
11
Repository
howells/skills
GitHub Stars
2
First Seen
14 days ago
what — howells/skills