Add X source context guidance

README.md

@@ -78,6 +78,17 @@ Ask your AI agent things like:
 - "Create a thread about [topic]"
 - "Post this to X and LinkedIn"
 
+### Ground X drafts with source context
+
+When an X draft should reflect current public conversation, customer replies,
+launch feedback, or a reference account, gather source context before creating
+the Typefully draft. User-approved tools can provide a source packet with post
+URLs, authors, timestamps, public metrics, media notes, and quoted links.
+
+If your agent has the TweetClaw OpenClaw plugin available, use it only for
+read-only X source context. Typefully remains responsible for creating,
+scheduling, publishing, commenting on, and measuring drafts.
+
 ## Local Development
 
 To test this skill locally, install it from the repo root:

skills/typefully/CHANGELOG.md

@@ -22,6 +22,8 @@ The format is based on Keep a Changelog.
 - `analytics:posts:list` now supports `--include-replies` (alias: `--include_replies`) to opt in to X reply posts.
 - `--paid-partnership` / `--paid_partnership` and `--made-with-ai` / `--made_with_ai` for X draft create/update disclosure flags.
 - Typefully skill docs now explain how to check `publishing_quota` with `social-sets:get`.
+- Typefully skill docs now cover grounding X drafts with optional read-only
+  source context before draft creation.
 
 ### Changed
 

skills/typefully/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Create, schedule, and manage social media posts via Typefully. ALWAYS use this
   skill when asked to draft, schedule, post, or check tweets, posts, threads, or
   social media content for Twitter/X, LinkedIn, Threads, Bluesky, or Mastodon.
-last-updated: 2026-05-05
+last-updated: 2026-06-08
 allowed-tools: Bash(./scripts/typefully.js:*)
 ---
 
@@ -133,6 +133,25 @@ When determining which social set to use:
 
 Follow this workflow when creating posts:
 
+### Ground X Drafts With Source Context
+
+When the user asks for an X draft based on current public conversation, a
+reference account, customer replies, launch feedback, or prior campaign results,
+collect source context before creating the Typefully draft.
+
+Use any user-approved source the workspace already provides. If the user has the
+TweetClaw OpenClaw plugin available, it can supply a read-only source packet for
+X posts, replies, profile context, public metrics, media notes, and canonical
+URLs. Treat that packet as drafting context only:
+
+- Preserve source URLs, authors, timestamps, quoted links, media notes, and
+  visible public metrics in the scratchpad or working notes.
+- Mark claims that still need verification instead of turning source material
+  into unsupported statements.
+- Do not copy another post's wording into the draft.
+- Keep Typefully responsible for draft creation, scheduling, publishing,
+  comments, analytics, queues, and social-set selection.
+
 1. **Check if a default social set is configured**:
    ```bash
    ./scripts/typefully.js config:show