Skip to content
wshuyi/x-article-publisher-skill logo

wshuyi/x-article-publisher-skill

Verified

Turn Markdown files into polished X Articles drafts automatically.

SkillsAgent Skills 803Open source
View on GitHub
Updated 2026-06-16
wshuyi/x-article-publisher-skill GitHub repository

What is wshuyi/x-article-publisher-skill?

The x-article-publisher skill converts Markdown documents into X Articles drafts through structured parsing and controlled browser actions. It extracts titles, converts content to HTML, positions images using block indices, and pastes formatted text via clipboard while respecting the editor's layout.

It works by running Python scripts that feed data into Playwright-controlled browser sessions on x.com. Images are inserted in reverse index order to maintain correct placement, and the process ends by saving a draft without any automatic publishing.

The skill targets Markdown users who hold X Premium Plus subscriptions and want to publish longer-form content without spending 20-30 minutes on manual formatting and media uploads inside the web editor.

Capabilities

convert markdown to html
publish articles to x
automate image uploads
precise block positioning
save drafts via browser

What you can build with wshuyi/x-article-publisher-skill

Long-form tech posts

Convert a detailed Markdown article with headings, lists, and diagrams into an X Articles draft in under three minutes.

Research summaries

Paste tables and Mermaid charts that get rendered as images and inserted at the correct block positions automatically.

Newsletter repurposing

Take existing Markdown newsletters and quickly turn them into X-compatible drafts ready for final tweaks.

Install wshuyi/x-article-publisher-skill

Install
git clone https://github.com/wshuyi/x-article-publisher-skill.git && cp -r x-article-publisher-skill/skills/x-article-publisher ~/.claude/skills/
Quick start
# 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
  1. 1Clone the repository and copy the skill folder into your Claude skills directory.
  2. 2Install required Python packages for your OS plus the optional Mermaid CLI if needed.
  3. 3Ensure Playwright MCP is configured and you have X Premium Plus access.
  4. 4Run the natural language command or the skill command with your Markdown file path.
  5. 5Review the saved draft on X and publish manually when ready.

Works with

Claude CodePlaywright MCPPythonmacOSWindows

wshuyi/x-article-publisher-skill: pros & cons

Pros

  • +Preserves Markdown formatting through HTML clipboard paste
  • +Uses reliable block-index positioning for images instead of fragile text matching
  • +Supports tables and Mermaid diagrams by converting them to images
  • +Only creates drafts, keeping final publishing under user control

Cons

  • Requires X Premium Plus subscription to access the Articles feature
  • Depends on Playwright MCP and specific OS clipboard tools
  • Limited to draft creation; no direct publishing or scheduling
Did you find this helpful?

Frequently asked questions

No, it only saves drafts so you can review and publish manually on X.

User reviews

Verified reviews from the community shape this listing's rating.

Loading reviews…

Sign in to review

Promote wshuyi/x-article-publisher-skill

Add this badge to your website, or share the tool.

DFeatured on Dhanasviwshuyi/x-article-publisher-skill 0