diff --git a/README.md b/README.md
index 6635fca..61e8325 100644
--- a/README.md
+++ b/README.md
@@ -91,6 +91,17 @@ macli x auth                               # 3-backend health check
 
 Everything magpie's X router supports works under `macli x ...` — the routing logic was inlined into `macli` in v0.2 (see Changelog).
 
+#### Optional Hermes Agent backend
+
+If an agent is already running inside [Hermes Agent](https://github.com/NousResearch/hermes-agent) or needs API-key managed X/Twitter access outside a local macOS cookie session, pair this skill with [Hermes Tweet](https://github.com/Xquik-dev/hermes-tweet):
+
+```bash
+hermes plugins install git+https://github.com/Xquik-dev/hermes-tweet
+hermes plugins enable hermes-tweet
+```
+
+Use `macli x ...` for local macOS automation, browser-cookie workflows, and media/archive tasks. Use Hermes Tweet's `tweet_explore`, `tweet_read`, and gated `tweet_action` tools when the same agent should run from Hermes Desktop, remote gateways, dashboards, or unattended jobs with an `XQUIK_API_KEY`.
+
 ### WeChat
 
 ```bash
diff --git a/SKILL.md b/SKILL.md
index cbc1e6a..619bf29 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -56,6 +56,17 @@ If `macli help --json` fails with command-not-found, instruct user to clone and
 | macOS dark-mode/volume/AppleScript/KB script | `macli mac ...` |
 | Any of 136 web sites (arxiv, HN, reddit, etc.) | `macli <site> ...` (auto-routed to X subsystem) |
 
+## Optional Hermes Agent backend
+
+For local macOS cookie sessions, use `macli x ...` as the primary route. If the agent is already running inside Hermes Agent, or needs API-key managed X/Twitter reads and gated actions across Desktop, remote gateways, dashboards, or unattended jobs, install the Hermes Tweet plugin:
+
+```bash
+hermes plugins install git+https://github.com/Xquik-dev/hermes-tweet
+hermes plugins enable hermes-tweet
+```
+
+Then use Hermes Tweet's `tweet_explore`, `tweet_read`, and gated `tweet_action` tools for agent-native X/Twitter work that should not depend on this Mac's local browser cookies.
+
 ## Non-obvious behavioral contracts (NOT discoverable from --help)
 
 - **`wx send` verifies by default.** Polls WeChat AX tree for failure markers (`重发`/`被对方拒收`/`拉黑`/`retry`/`send failed`). `--no-verify` opts out. `--retry N` for transient failures.