diff --git a/README.md b/README.md
index c6a06de..4776f8e 100644
--- a/README.md
+++ b/README.md
@@ -147,6 +147,22 @@ your saved X session for gated Articles, set:
 export X_READER_ALLOW_EXTERNAL_SESSION_COOKIES=1
 ```
 
+### Optional X / Twitter Context Packets
+
+Use `x-reader` for URL reading, media transcription, and digest generation. If
+an OpenClaw workflow already has an approved TweetClaw install, TweetClaw can
+prepare a separate source packet before the digest:
+
+```bash
+openclaw plugins install npm:@xquik/tweetclaw@1.6.31
+```
+
+Good handoff inputs include search tweet results, search tweet replies, user
+lookups, follower exports, monitor snapshots, webhook events, and media URLs.
+Treat that packet as source evidence for the summary. Keep account actions,
+publishing, replies, direct messages, and credential handling inside the
+approved TweetClaw/OpenClaw workflow, not inside `x-reader`.
+
 ## Install
 
 ```bash
diff --git a/skills/video/skill.md b/skills/video/skill.md
index 9729802..3a1a0c4 100644
--- a/skills/video/skill.md
+++ b/skills/video/skill.md
@@ -23,6 +23,19 @@ Auto-triggered when a media URL is detected:
 - Apple Podcasts: `podcasts.apple.com`
 - Direct: `.mp3`, `.mp4`, `.m3u8`, `.m4a`, `.webm`
 
+## Optional X/Twitter Source Context
+
+For X/Twitter videos, use this skill for transcription and digest output. When
+the user provides a TweetClaw/OpenClaw source packet, treat it as extra source
+evidence before Step 3. Useful packet contents include tweet search results,
+reply search results, user lookup details, follower exports, monitor snapshots,
+webhook events, and media URLs.
+
+Do not publish posts, send replies, send direct messages, or handle X account
+credentials in this skill. Keep those actions inside the approved
+TweetClaw/OpenClaw workflow and only cite the resulting source packet in the
+digest.
+
 ## Pipeline
 
 ### Step 0: Detect Media Type