diff --git a/commands/token-card.md b/commands/token-card.md
index 9c4f78abe..db7a200d5 100644
--- a/commands/token-card.md
+++ b/commands/token-card.md
@@ -12,7 +12,7 @@ slash-command harnesses can reach it.
 ## Usage
 
 ```
-/token-card                       # write ./tokenchit.svg
+/token-card                       # write the configured output (./tokenchit.svg by default)
 /token-card --out docs/usage.svg  # write somewhere else
 /token-card --theme dark
 /token-card --dry-run             # report what would be written, write nothing
diff --git a/skills/token-card/SKILL.md b/skills/token-card/SKILL.md
index 0d7b21fa4..2451edf5e 100644
--- a/skills/token-card/SKILL.md
+++ b/skills/token-card/SKILL.md
@@ -66,7 +66,8 @@ npm view @tokenchit/cli@0.10.0 dist.integrity dist.tarball
    **Skip this entirely when the user passed `--dry-run`**, and report that `.tokenchit.json`
    *would* be created. A preview that writes a config file is not a preview.
 
-3. **Render the card.** The bare command, which writes `tokenchit.svg` in the repository root:
+3. **Render the card.** The bare command writes to the configured output — `tokenchit.svg`
+   unless `.tokenchit.json` names another path:
 
    ```bash
    npx -y @tokenchit/cli@0.10.0 sync
@@ -79,7 +80,7 @@ npm view @tokenchit/cli@0.10.0 dist.integrity dist.tarball
 
    | Flag | Effect |
    |---|---|
-   | `--out <path>` | Write somewhere other than `tokenchit.svg` |
+   | `--out <path>` | Write somewhere other than the configured output |
    | `--theme auto` \| `light` \| `dark` | Card theme; `auto` adapts to the reader's system |
    | `--dry-run` | Print what would be written and touch nothing |
 
@@ -96,6 +97,9 @@ npm view @tokenchit/cli@0.10.0 dist.integrity dist.tarball
    ![tokenchit](./tokenchit.svg)
    ```
 
+   Use the path `sync` actually reported, not this one, when the output is configured
+   elsewhere.
+
    Do not edit the README without being asked.
 
 Stop after step 4. Publishing to the public leaderboard is a separate `publish` command that