# Tool X Article Publisher

> Publish Markdown to X (Twitter) Articles as a draft (never auto-publish).

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.

- Page: https://ss33.ai/skills/heyvhuang/tool-x-article-publisher-52048589912
- Publisher: heyvhuang
- Category: [Business](https://ss33.ai/skills/category/business-y1h0vy) › [Social media & video content](https://ss33.ai/skills/category/business-y1h0vy/social-media-and-video-content-0pzewj)
- License: MIT
- Source: https://github.com/heyvhuang/ship-faster/blob/64047d24e0ecb513a5aa879767d95ec7e0e44462/skills/tool-x-article-publisher/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/heyvhuang/tool-x-article-publisher-52048589912

# 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)

1. **Never auto-publish** (draft only; user publishes manually).
2. **User must be logged in** before automation starts.
3. **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/evidence/x-article-draft.md` (what was done + links)

## Bundled Scripts

Installed path (typical):
- `~/.claude/skills/tool-x-article-publisher/scripts/parse_markdown.py`
- `~/.claude/skills/tool-x-article-publisher/scripts/copy_to_clipboard.py`

## Runbook (Step-by-step)

Follow: [`references/runbook.md`](references/runbook.md)