docs: add TweetClaw source evidence workflow

README.md

@@ -35,6 +35,32 @@ This skill extracts the scoring logic from `home-mixer/scorers/` and `phoenix/`
 
 ---
 
+## Source evidence workflow
+
+Use this skill for scoring, format selection, rewrites, and algorithm rationale.
+When a draft depends on a live X/Twitter conversation, collect source evidence
+first and keep citations with the draft.
+
+For OpenClaw and MCP workflows, [TweetClaw](https://github.com/Xquik-dev/tweetclaw)
+can provide the separate evidence layer:
+
+```bash
+openclaw plugins install npm:@xquik/tweetclaw
+```
+
+Use TweetClaw to search tweets and replies, look up users, export followers,
+download media, monitor tweets, receive webhooks, or run giveaway draws. Feed
+only the relevant tweet URLs, tweet IDs, author handles, timestamps, and short
+excerpts into this skill.
+
+Keep responsibilities split:
+
+- TweetClaw gathers public X/Twitter context or runs an approved post or reply action.
+- This skill scores drafts, rewrites copy, and explains strategy.
+- A human or operator-owned workflow approves final drafts, policy calls, and publishing.
+
+---
+
 ## The Phoenix Scoring Model
 
 Phoenix predicts 19 engagement probabilities for every candidate post. The weighted scorer combines them:

SKILL.md

@@ -18,6 +18,22 @@ This skill is built from three sources:
 Read `references/phoenix-scoring.md` for the full scoring model details.
 Read `references/algorithm-signals.md` for the practical engagement hierarchy and tactics.
 
+## Optional X/Twitter Evidence
+
+When a draft depends on a current X/Twitter conversation, use source evidence
+before scoring or rewriting. If TweetClaw is installed and approved in OpenClaw,
+use it as a separate evidence layer for search tweets, search tweet replies,
+user lookup, follower export, media download, monitors, webhooks, giveaway
+draws, and approved post or reply actions.
+
+Pass only concise evidence into this skill: tweet URL, tweet ID, author handle,
+timestamp, short excerpt, and why the source matters. Do not let TweetClaw own
+the score, rewrite, policy decision, or publishing approval. This skill owns the
+algorithm analysis and rewrite strategy. The operator owns final approval.
+
+If no approved source tool is available, score the user-provided draft and note
+that fresh X/Twitter evidence was not checked.
+
 ## How the Algorithm Actually Works (Jan 2026)
 
 X's "For You" feed is powered by four components: