X Article Publisher Skill

English | 中文

Publish Markdown articles to X (Twitter) Articles with one command. Say goodbye to tedious rich text editing.

v1.2.0 — Now with divider support, table-to-image, Mermaid support, and cross-platform clipboard

---

The Problem

If you're used to writing in Markdown, publishing to X Articles is a painful process:

Time Comparison

10x efficiency improvement

---

The Solution

This skill automates the entire publishing workflow:

Markdown File
     ↓ Python parsing
Structured Data (title, images with block_index, HTML)
     ↓ Playwright MCP
X Articles Editor (browser automation)
     ↓
Draft Saved (never auto-publishes)

Key Features

• Rich Text Paste: Convert Markdown to HTML, paste via clipboard — all formatting preserved
• Block-Index Positioning (v1.1): Precise image placement using element indices, not text matching
• Reverse Insertion: Insert images from highest to lowest index to avoid position shifts
• Smart Wait Strategy: Conditions return immediately when met, no wasted wait time
• Safe by Design: Only saves as draft, never publishes automatically

---

What's New in v1.1.0

Why Block-Index?

Previously, images were positioned by matching surrounding text — this failed when:

• Multiple paragraphs had similar content
• Text was too short to be unique

Now, each image has a block_index indicating exactly which block element it follows. This is deterministic and reliable.

---

Requirements

# macOS
pip install Pillow pyobjc-framework-Cocoa

# Windows
pip install Pillow pywin32 clip-util

# For Mermaid diagrams (optional)
npm install -g @mermaid-js/mermaid-cli

---

Installation

Method 1: Git Clone (Recommended)

git clone https://github.com/wshuyi/x-article-publisher-skill.git
cp -r x-article-publisher-skill/skills/x-article-publisher ~/.claude/skills/

Method 2: Plugin Marketplace

/plugin marketplace add wshuyi/x-article-publisher-skill
/plugin install x-article-publisher@wshuyi/x-article-publisher-skill

---

Usage

Natural Language

Publish /path/to/article.md to X

Help me post this article to X Articles: ~/Documents/my-post.md

Skill Command

/x-article-publisher /path/to/article.md

---

Workflow Steps

[1/7] Parse Markdown...
      → Extract title, cover image, content images with block_index
      → Convert to HTML, count total blocks

[2/7] Open X Articles editor...
      → Navigate to x.com/compose/articles

[3/7] Upload cover image...
      → First image becomes cover

[4/7] Fill title...
      → H1 used as title (not included in body)

[5/7] Paste article content...
      → Rich text via clipboard
      → All formatting preserved

[6/7] Insert content images (reverse order)...
      → Sort by block_index descending
      → Click block element at index → Paste image
      → Wait for upload (returns immediately when done)

[7/7] Save draft...
      → ✅ Review and publish manually

---

Supported Markdown

---

Example

Input: article.md

# 5 AI Tools Worth Watching in 2024

![cover](./im

...