| name | publish-x-article |
| description | Publish Markdown to X (Twitter) Articles as a draft (never auto-publish). Use when the user asks to publish/post an article to X Articles, convert Markdown to X Articles rich text, or mentions "X article", "publish to X", "post to Twitter articles". Converts Markdown → HTML, pastes rich text, and inserts images deterministically. |
X Article Publisher
Publish Markdown content into X (Twitter) Articles as a draft, preserving formatting via rich text paste and deterministic image insertion.
Hard Rules (Safety)
- Never auto-publish (draft only; user publishes manually).
- User must be logged in before automation starts.
- First image = cover image (if any).
Prerequisites
- Browser automation available (Playwright MCP or equivalent)
- X account can access Articles (Premium / Premium Plus)
- macOS recommended (clipboard helper uses Cocoa)
- Python 3.9+ with:
pip install Pillow pyobjc-framework-Cocoa
Inputs / Outputs (Recommended)
Inputs (paths only):
article_md_path: Markdown file to publish- Optional:
run_dir for artifacts (otherwise use /tmp/)
Outputs (recommended artifacts):
/tmp/x_article.json (parsed structure)/tmp/x_article.html (HTML body for paste)- Optional:
run_dir/05-final/x-article-draft.md (what was done + links)
Bundled Scripts
Installed path (typical):
~/.claude/skills/publish-x-article/scripts/parse_markdown.py~/.claude/skills/publish-x-article/scripts/copy_to_clipboard.py
Runbook (Step-by-step)
Follow: references/runbook.md
