diff --git a/skills/docs-source.json b/skills/docs-source.json
index 905d2b9..409bfcc 100644
--- a/skills/docs-source.json
+++ b/skills/docs-source.json
@@ -1,5 +1,5 @@
 {
   "repository": "stack-sh/docs",
-  "revision": "69e4615c5356b44517fa557bea248ea2fe008631",
-  "manifestSha256": "3f84b30a4fb6216c96b13b53035bf62003504eee686fd7e44867c711da0fcfea"
+  "revision": "cd7ba0356de8a70d8932036b0e6ea37519577fd0",
+  "manifestSha256": "4187e92ff990702d53586db14658dc15a3721c69d42501a4d5b4c615a8e31552"
 }
diff --git a/skills/stack-diagrams/SKILL.md b/skills/stack-diagrams/SKILL.md
index e48f3ed..1acb976 100644
--- a/skills/stack-diagrams/SKILL.md
+++ b/skills/stack-diagrams/SKILL.md
@@ -12,7 +12,7 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese
 
 ## Start with the available tools
 
-Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. The published CLI 0.4.0 supports `check`, `fmt`, and `render`; it does not support their `--json` flags. A newer version may support additional options: verify them using `stack help <command>`.
+Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.4.0 using `check`, `fmt`, and `render` without `--json` for compatibility. Before using additional options such as JSON output, verify them using `stack help <command>`.
 
 If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.4.0/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required.