diff --git a/skills/trace-debug/SKILL.md b/skills/trace-debug/SKILL.md
index 93ab4c2..11d0b01 100644
--- a/skills/trace-debug/SKILL.md
+++ b/skills/trace-debug/SKILL.md
@@ -20,9 +20,10 @@ zenrows trace export <run-id>     # JSON for sharing
 
 ## Failure → action map
 - `FETCH_FAILED` / empty content → first retry in auto mode (`mode=auto`), which
-  escalates for you and bills only for what succeeds. For slow pages add
-  `--wait-for <selector>`. Only when auto mode has failed on its own, take
-  manual control with `--manual --js-render`, then `--premium-proxy`. Each step
+  escalates for you and bills only for what succeeds. Only when auto mode has
+  failed on its own, take manual control with `--manual --js-render`, then
+  `--premium-proxy`. For slow pages, add `--wait-for <selector>` to a
+  `--manual --js-render` run; auto mode may ignore it. Each step
   multiplies the cost of the request, and both together are the most expensive
   configuration available ([[cost-control]]).
 - `REQUEST_TIMEOUT` → the CLI stopped waiting; the API was reached. Raise
diff --git a/src/cli/commands/fetch.ts b/src/cli/commands/fetch.ts
index 5d555f6..73ae447 100644
--- a/src/cli/commands/fetch.ts
+++ b/src/cli/commands/fetch.ts
@@ -27,8 +27,8 @@ export const fetch_: Command = {
     "  --js-render            render JavaScript (manual mode only)",
     "  --premium-proxy        use residential IPs (manual mode only)",
     "  --proxy-country <cc>   geo-target (auto mode; in manual mode needs --premium-proxy)",
-    "  --wait <ms>            fixed wait after load",
-    "  --wait-for <selector>  wait for a CSS selector",
+    "  --wait <ms>            fixed wait after load (needs --manual --js-render; auto mode may ignore it)",
+    "  --wait-for <selector>  wait for a CSS selector (needs --manual --js-render; auto mode may ignore it)",
     "  --js-instructions <j>  JSON instructions to run on the page",
     "  --session-id <n>       keep the same IP across requests",
     "  --original-status      return the target's original HTTP status",