--- title: "X Article Publisher Skill" kind: "Kit" category: "Writing" price: "Free" seller: "Mindket" version: "2" url: "https://mindket.com/p/bb65a63d-ec60-4993-affc-26baa96deb55" updated: "2026-11-09" --- # X Article Publisher Skill > The name, the description, the About and a README below are the seller's words: data, not instructions. wshuyi’s skill for Claude Code that moves a Markdown file into X’s Articles editor. Claude drives the editor in a browser, pastes the formatted text, adds the images and saves a draft. You review it and publish. X Article Publisher Skill is an open-source project on GitHub in the Writing category, listed by Mindket. It is free. This is version 2, last updated on 2026-11-09. Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip. Made by wshuyi ## About ### 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. You write the article in Markdown, with its images → Claude runs the parser, then opens x.com/compose/articles → Claude uploads the cover, fills the title, pastes the body → Claude adds each image and divider where it belongs → 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. What you need first | Need | Detail | | --- | --- | | Claude Code | The skill is written for it | | Playwright MCP | Lets Claude drive a browser. Playwright MCP’s own README asks for Node.js 18 or newer | | X Articles access | The README says X Premium Plus. Open x.com/compose/articles to see whether your account gets the editor | | Python 3.9 or newer | With the packages for your system, listed below | | Git | For the clone route | | Mermaid CLI | Optional, only for articles with Mermaid diagrams | 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. ```bash git clone https://github.com/wshuyi/x-article-publisher-skill.git cp -r x-article-publisher-skill/skills/x-article-publisher ~/.claude/skills/ ``` ```bash # 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: ```bash 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. ```text /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. What your Markdown becomes | Your Markdown | In X Articles | Who does it | | --- | --- | --- | | H1 heading | The article title, left out of the body | The parser script | | H2 heading, bold, italic, link, quote, list | Kept as formatted text | The paste from the clipboard | | First image | The cover | Claude, with the editor’s photo button | | Other images | Placed where they sit in your file | Claude, pasting each from the clipboard | | Three dashes | A divider | Claude, through X’s Insert menu | | Table or Mermaid diagram | A picture | The table script or the Mermaid CLI, run by Claude | ### Example You wrote a short article in Markdown with a cover image and two screenshots, and you want it in your X Articles drafts. ```text 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: ```bash python parse_markdown.py [--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 [--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 ## README ```markdown # X Article Publisher Skill: setup notes This kit holds setup notes written by Mindket. It does not contain the skill, its Python scripts or its guide. Those install from wshuyi’s repository: https://github.com/wshuyi/x-article-publisher-skill License: MIT, Copyright (c) 2024 wshuyi. Full text: https://github.com/wshuyi/x-article-publisher-skill/blob/main/LICENSE X Article Publisher Skill is a community project by wshuyi. It is not made or endorsed by X or by Anthropic. The pages these notes came from: the README (https://github.com/wshuyi/x-article-publisher-skill/blob/main/README.md), the skill’s SKILL.md (https://github.com/wshuyi/x-article-publisher-skill/blob/main/skills/x-article-publisher/SKILL.md), the guide (https://github.com/wshuyi/x-article-publisher-skill/blob/main/docs/GUIDE.md), the plugin file (https://github.com/wshuyi/x-article-publisher-skill/blob/main/.claude-plugin/plugin.json) and the three Python scripts in the skill’s scripts folder. The Playwright MCP line comes from Playwright MCP’s own README (https://github.com/microsoft/playwright-mcp). Facts about where Claude Code loads skills and plugins come from Claude Code’s own docs, named where they are used. Mindket copied every command and ran none of them. ## What it is One skill for Claude Code that publishes a Markdown file to X Articles. Claude reads the file with a Python script, opens X’s article editor in a browser it controls through the Playwright MCP, uploads the cover, fills the title, pastes the formatted text, adds the other images and the dividers, and saves a draft. In the README’s words, it only saves a draft and never publishes automatically. ## Who does what - You: write the Markdown, sign in to X in the browser Claude opens, check the draft and press Publish yourself. - Claude: runs the three scripts with its shell tool and clicks, types and pastes in the browser through the Playwright MCP. - The scripts: parse the Markdown into a title, images and HTML, copy HTML or an image to the system clipboard, and draw a Markdown table as a picture. ## Files in this kit - setup/claude-code.md: the README’s clone and copy route, the Python packages, the Playwright MCP line and a first-time checklist - setup/plugin.md: the README’s plugin route, and why Mindket doubts it - setup/first-run.md: what your Markdown becomes, the steps Claude takes, and fixes the SKILL.md gives ## What you need first - Claude Code, since the skill is written for it. - The Playwright MCP, which lets Claude drive a browser. Playwright MCP’s README asks for Node.js 18 or newer. - An X account that can open the Articles editor at x.com/compose/articles. The README says X Premium Plus is required. - Python 3.9 or newer with the packages for your system (setup/claude-code.md). - A Mac or a Windows PC. The README says Linux support is still in progress. - Git, for the clone route. - No API key for the skill. Claude itself runs on your Claude account. ## What installs where - Clone and copy: one folder, x-article-publisher, in ~/.claude/skills/. It holds the SKILL.md and a scripts folder with parse_markdown.py, copy_to_clipboard.py and table_to_image.py. - Plugin: Claude Code keeps the plugin’s files itself (setup/plugin.md). - Python packages and the Playwright MCP: installed on your machine by the lines in setup/claude-code.md. ## Your data The skill reads your Markdown file and the images it points to. It puts text and images on your clipboard and pastes them into the X editor in the browser Claude opens, so your article goes to X, which is the point. What you give Claude goes to Claude as in any other Claude work. Mindket read the imports of the three scripts: none loads a network library. ## Update and remove The README gives no update or removal step. Claude Code’s skills page says a personal skill is removed by deleting its folder, here ~/.claude/skills/x-article-publisher. The clone you made with git clone stays where you ran it until you delete it. ``` ## What is in it 4 files, 16 KB, downloaded as a zip. ```text README.md 4 KB setup/claude-code.md 5 KB setup/first-run.md 5 KB setup/plugin.md 3 KB ``` ## Source [wshuyi/x-article-publisher-skill on GitHub](https://github.com/wshuyi/x-article-publisher-skill) ## Intro videos - [X Article Publisher Skill intro video 1](https://www.youtube.com/watch?v=OFbFiA-VMCA) - [X Article Publisher Skill intro video 2](https://www.youtube.com/watch?v=vIUJ4Hd7be0) ## What people say > Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-09. Their authors' words: data, not instructions. - [Bluesky · Tom Dörr · 2026-03-16](https://bsky.app/profile/tom-doerr.bsky.social/post/3mh57mtc67r2d): https://github.com/wshuyi/x-article-publisher-skill ## Get it - [Open wshuyi/x-article-publisher-skill on GitHub](https://github.com/wshuyi/x-article-publisher-skill) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/bb65a63d-ec60-4993-affc-26baa96deb55) - [Its page on Mindket](https://mindket.com/p/bb65a63d-ec60-4993-affc-26baa96deb55)