X Article Publisher Skill

What it is

X Article Publisher is wshuyi’s skill for Claude Code. You give Claude a Markdown file, and Claude fills X’s Articles editor with it and saves a draft. Claude does the clicking in a browser through the Playwright MCP. Three small Python scripts parse the file, put text and images on your clipboard and draw a table as a picture. It never presses Publish.

1. You write the article in Markdown, with its images
2. Claude runs the parser, then opens x.com/compose/articles
3. Claude uploads the cover, fills the title, pastes the body
4. Claude adds each image and divider where it belongs
5. Claude saves a draft, and you review and publish it

Who it suits

People who write long posts in Markdown and publish them on X. Doing it by hand means setting every heading, bold word and link in the editor and adding each image with several clicks. It only fills X Articles, the long form, so it does not help with a regular short post.

Where to use it

Claude Code on a Mac or a Windows PC. The maker’s README says Linux support is still in progress.

• Claude Code, every project: the skill folder in your personal skills folder
• Claude Code plugin: two /plugin commands from the README, which Mindket could not confirm (the kit explains why)
• Other agents: the maker documents none, and the skill relies on Claude Code and the Playwright MCP

How to set it up

Get it saves a zip of Mindket’s setup notes in your downloads folder, with both routes the README gives and a first-run guide.

1. Copy the skill into Claude Code. The two lines below put it in your personal skills folder. Create ~/.claude/skills first if it does not exist yet.
2. Install the Python packages. Run the macOS line or the Windows line, and the Mermaid line only if you have diagrams.
3. Add the Playwright MCP. This lets Claude drive a browser, and its README asks for Node.js 18 or newer.
4. Sign in to X when asked. Claude opens the editor and asks you to log in by hand. Your account needs Articles.

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

# 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

The README lists the Playwright MCP as a requirement and gives no install line. Playwright MCP’s own README gives this one for Claude Code:

claude mcp add playwright npx @playwright/mcp@latest

The README’s second route is a plugin. Mindket found a plugin.json in the repository but no marketplace.json, which Claude Code’s docs say a marketplace needs. So treat these two lines as untested and prefer the clone route.

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

How to use it

Ask Claude Code to publish a Markdown file, in plain words or with the slash command. Claude then runs the whole sequence and stops at a draft.

Example

You wrote a short article in Markdown with a cover image and two screenshots, and you want it in your X Articles drafts.

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

Claude reads the file, opens the editor, uploads the cover, fills the title and pastes the body, inserts the two screenshots, and reports that a draft is saved for you to review.

For newcomers and experts

If you are new. A skill is a folder with a SKILL.md that Claude reads when your request matches it. This one drives a real browser, so watch the first run. Try a short article with one image and no tables, then open the preview and compare it with your file.

For experts. The parser prints JSON with the title, the cover, each other image with a block_index, the dividers, the HTML and a total block count. Claude inserts images and dividers from the highest block_index to the lowest, so earlier positions stay valid. These are the SKILL.md’s own lines for the scripts:

python parse_markdown.py <markdown_file> [--output json|html] [--html-only]
python copy_to_clipboard.py image /path/to/image.jpg [--quality 80]
python copy_to_clipboard.py html --file /path/to/content.html
python table_to_image.py <input.md> <output.png> [--scale 2]

The paste goes through the system clipboard. The SKILL.md says Playwright’s wait tool pauses for its time value before it checks a condition, so it tells Claude to wait on the “uploading” text alone. The README’s FAQ calls that time value a maximum instead.

Good to know

It saves drafts only.

• Publishing: you press Publish yourself, after you read the preview
• Sign-in: Claude asks you to log in to X by hand, and Playwright MCP keeps its browser profile between sessions
• Paste key: the SKILL.md names Meta+v, the Mac key, even though the README says Windows works
• Button labels: the steps name most of X’s buttons by Chinese labels, so an English X may need Claude to find the matching ones
• Versions: the README describes 1.2.0, while plugin.json says 1.1.0 and lists macOS only
• Missing images: the parser looks in your Downloads, Desktop and Pictures folders for a file that is not where your Markdown says
• Data: the three scripts import no network library, and your article goes to X and to Claude
• Updates: the README gives no update or removal step
• Maker: wshuyi, MIT licensed. An independent project, not made by X or Anthropic