diff --git a/README.md b/README.md index bebac74..266478a 100644 --- a/README.md +++ b/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: diff --git a/skills/typefully/CHANGELOG.md b/skills/typefully/CHANGELOG.md index cdde431..183116d 100644 --- a/skills/typefully/CHANGELOG.md +++ b/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 diff --git a/skills/typefully/SKILL.md b/skills/typefully/SKILL.md index a0bd016..207504a 100644 --- a/skills/typefully/SKILL.md +++ b/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