describing-changes: default to no body when diff suffices
Assisted-by: Claude Sonnet 5 via Claude Code
change zylkuzxwxryzqlmwqpuwvqpxnuvqwuqw
commit 2de900b00362ddc3ee7b42fe298d5f3d8b373edf
author Alpha Chen <alpha@kejadlen.dev>
date
parent zlslkvyk
diff --git a/ai/skills/describing-changes/SKILL.md b/ai/skills/describing-changes/SKILL.md
index f1968e57..e6a71ade 100644
--- a/ai/skills/describing-changes/SKILL.md
+++ b/ai/skills/describing-changes/SKILL.md
@@ -88,6 +88,11 @@ default.
 - A reader can already reconstruct the reasoning from the diff alone.
 - The body would only paraphrase what the diff already shows.
 
+A rationale you *can* construct isn't automatically one worth writing —
+if the diff already makes it obvious, a constructed sentence is
+decoration, not information. Default to no body; add one only when it
+earns its place.
+
 Otherwise, write one — cover what changed, naming the file or
 function when it orients the reader, and why.