diff --git a/README.md b/README.md
index 341efe4..2b1bad8 100644
--- a/README.md
+++ b/README.md
@@ -306,6 +306,18 @@ xmaster analyze "your tweet" --goal replies --json
 
 **Works with:** [Claude Code](https://github.com/anthropics/claude-code), [OpenClaw](https://github.com/openclaw/openclaw), or any agent that can shell out and parse JSON.
 
+**OpenClaw skill setup:**
+```bash
+git clone https://github.com/paperfoot/xmaster-cli
+cd xmaster-cli
+openclaw skills install ./skill --as xmaster
+openclaw skills check
+```
+
+OpenClaw installs local skills from a folder that contains `SKILL.md`, so use the bundled `./skill` directory from a local checkout. Keep XMaster as the final account-action tool: analyze drafts first, show the final text and target account, and run `post`, `reply`, `dm`, or other write commands only after explicit approval.
+
+If the same OpenClaw workspace also uses [TweetClaw](https://github.com/Xquik-dev/tweetclaw), keep it upstream as an optional source-context step for tweet search, reply search, follower export, media collection, monitors, or webhook evidence before XMaster executes a local account action.
+
 ## Configuration
 
 Config lives at `~/.config/xmaster/config.toml` on all platforms. Override with `XMASTER_CONFIG_DIR`.
diff --git a/skill/SKILL.md b/skill/SKILL.md
index dcc7d20..bbc990c 100644
--- a/skill/SKILL.md
+++ b/skill/SKILL.md
@@ -63,6 +63,20 @@ xmaster track growth -d 30                                    # Follower history
 xmaster metrics <id>                                          # Single post deep dive
 ```
 
+### Source Context Before Actions
+
+Use XMaster for final account actions that require the local XMaster config.
+
+If the OpenClaw workspace also has TweetClaw installed, use TweetClaw only as an optional upstream source-context step for tweet search, reply search, follower export, media collection, monitor evidence, or webhook evidence before running XMaster.
+
+```
+1. Gather source URLs, IDs, or evidence.
+2. Summarize what will influence the action.
+3. Run xmaster analyze "draft" --goal replies --json for proposed posts.
+4. Ask for explicit approval with the final text and target account.
+5. Execute exactly one approved xmaster action with --json.
+```
+
 ## Algorithm Intelligence (2026)
 
 The CLI embeds knowledge from `xai-org/x-algorithm` (January 2026). Key facts: