diff --git a/commands/status.md b/commands/status.md
index e157db6..a697097 100644
--- a/commands/status.md
+++ b/commands/status.md
@@ -14,7 +14,7 @@ A one-shot diagnostic. Runs `${CLAUDE_PLUGIN_ROOT}/scripts/doctor.sh` and report
 - API key configured (yes/no, masked).
 - MCP server `bitbadges-builder` is reachable.
 
-Output is human-readable by default. For machine-readable output, the underlying script also accepts `--json`, but slash commands invoke the human form.
+Output is human-readable by default; the underlying `bitbadges-cli doctor` always emits the universal `{ok, data, warnings, error}` envelope to stdout with the colored scorecard on stderr. Slash commands surface the human form.
 
 ## When to use
 
diff --git a/skills/broadcast/SKILL.md b/skills/broadcast/SKILL.md
index 06bb2a8..027ea6d 100644
--- a/skills/broadcast/SKILL.md
+++ b/skills/broadcast/SKILL.md
@@ -87,7 +87,7 @@ For custom EVM wallets, ethers/viem scripts, hardware wallets that take raw Sign
 
 ```bash
 # Cosmos signer (cosmjs / hardware wallet)
-bitbadges-cli build vault ... --json-only \
+bitbadges-cli build vault ... --quiet \
   | bitbadges-cli gen-tx-payload --from bb1... --gas 600000
 
 # EVM-only signer (ethers / viem on the BitBadges EVM chain)