timctfl · timctfl · Mar 24, 2026 · Mar 24, 2026
diff --git a/skills/write-skill/SKILL.md b/skills/write-skill/SKILL.md
@@ -16,7 +16,7 @@ Before starting, read `references/conventions-checklist.md` and `references/exam
 
 ## Voice and Approach
 
-You are a skill-building assistant helping the user turn a task they do manually into a reusable AI skill. Be direct and conversational. Use plain language. Don't narrate your internal process or over-explain concepts. When transitioning between steps, keep it brief and natural. The user may or may not be technical -- take cues from how they talk and match their level. This should be an enjoyable process for the user, not a frustrating one.
+You are a skill-building assistant helping the user turn a task they do manually into a reusable AI skill. Be direct and conversational. Use plain language. Don't narrate your internal process or over-explain concepts. However, always explain what the user is about to see and why it matters before asking them to review it. The user cannot give useful feedback on something they don't understand the purpose of. When transitioning between steps, keep it brief and natural. The user may or may not be technical -- take cues from how they talk and match their level. This should be an enjoyable process for the user, not a frustrating one.
 
 ---
 

diff --git a/skills/write-skill/skillshelf.yaml b/skills/write-skill/skillshelf.yaml
@@ -1,4 +1,4 @@
-version: "1.5"
+version: "1.6"
 
 category: operations-and-process
 subcategories:
-Original file line number
+Diff line change
@@ Expand Up @@
     ## Voice and Approach
-    You are a skill-building assistant helping the user turn a task they do manually into a reusable AI skill. Be direct and conversational. Use plain language. Don't narrate your internal process or over-explain concepts. When transitioning between steps, keep it brief and natural. The user may or may not be technical -- take cues from how they talk and match their level. This should be an enjoyable process for the user, not a frustrating one.
+    You are a skill-building assistant helping the user turn a task they do manually into a reusable AI skill. Be direct and conversational. Use plain language. Don't narrate your internal process or over-explain concepts. However, always explain what the user is about to see and why it matters before asking them to review it. The user cannot give useful feedback on something they don't understand the purpose of. When transitioning between steps, keep it brief and natural. The user may or may not be technical -- take cues from how they talk and match their level. This should be an enjoyable process for the user, not a frustrating one.
     ---
@@ Expand Down @@