X Article Publisher skill

A Claude Code skill that moves a Markdown article into the X Articles editor with formatting and images

  • 873 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • Drives a browser in a logged-in X account
  • Uses the system clipboard
All reasons and checks
Needs a VPN

wshuyi/x-article-publisher-skill

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/x-article-publisher

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Drives a browser in a logged-in X account
  • Uses the system clipboard

This is third-party code. Review the repository files before installing.

What it does

The skill parses a Markdown file: the H1 becomes the article title, the first image becomes the cover, and other images get the index of the block they follow. Text is converted to HTML and pasted into the X editor via the clipboard, so headings, lists, quotes and links survive. Playwright MCP drives the browser and images are inserted from last to first so positions do not shift. Tables and Mermaid diagrams can be converted to PNG beforehand. The article is only saved as a draft; a human publishes it.

Who it is for. For writers who draft in Markdown and publish long articles on X with a Premium Plus subscription.

Good fit when

  • You need to move a finished article into X Articles without manual formatting
  • The article has many images and their positions matter

Not a fit when

  • You do not have X Premium Plus
  • You work on Linux
  • You need to publish to other social networks

Example request

Publish ~/Documents/post.md to X Articles as a draft

Limitations

Requires Claude Code, Playwright MCP, an X login with Premium Plus and Python 3.9+ with Pillow and clipboard libraries. macOS and Windows are supported; Linux is not yet. One run works with one account; switch accounts manually.

How to disable. Delete ~/.claude/skills/x-article-publisher or uninstall the plugin via /plugin uninstall.

FAQ

Does the skill publish the article?

No, it only saves a draft; publishing is up to you.

What about tables?

X Articles does not render them, so table_to_image.py turns a table into a PNG.

Discussion

No questions or reviews yet.

Skills
Needs a VPN

Four Claude Code skills that take a post for X from gathering material and picking topics to a ready draft

SkillExtended access343Repository stars
Russian stack

A 10-stage Claude Code pipeline: Wordstat semantics, top-5 competitor analysis, AI cover and illustrations, publishing to WordPress, Dzen and Prisma Blog

SkillExtended access6Repository stars

A WeChat article layout skill: turns Markdown into paste-ready HTML with inlined styles that survives pasting into the official account editor

SkillExtended access4.2KRepository stars
Needs a VPN

Skill that finds illustration spots in an article and generates images, diagrams and covers with three engines

SkillExtended access569Repository stars
Needs a VPN

A social content skill: learns your voice, plans content, writes posts and, after confirmation, publishes through your logged-in Chrome

SkillBroad access743Repository stars

Humanities Writing Companion walks a humanities paper through 12 modes: from sharpening the research question to a blind read and AI-use disclosure

SkillMinimal access470Repository stars

README in short

The README describes formatting loss when moving Markdown into X and the fix via file parsing, the clipboard and browser automation. It lists requirements, two install methods, the skill's steps and a table of supported markup. An example input file and parsed output are included. MIT licensed.

README badge

Original SKILL.md

---
name: x-article-publisher
description: |
  Publish Markdown articles to X (Twitter) Articles editor with proper formatting. Use when user wants to publish a Markdown file/URL to X Articles, or mentions "publish to X", "post article to Twitter", "X article", or wants help with X Premium article publishing. Handles cover image upload and converts Markdown to rich text automatically.
---

# X Article Publisher

Publish Markdown content to X (Twitter) Articles editor, preserving formatting with rich text conversion.

## Prerequisites

- Playwright MCP for browser automation
- User logged into X with Premium Plus subscription
- Python 3.9+ with dependencies:
  - macOS: `pip install Pillow pyobjc-framework-Cocoa`
  - Windows: `pip install Pillow pywin32 clip-util`
- For Mermaid diagrams: `npm install -g @mermaid-js/mermaid-cli`

## Scripts

Located in `~/.claude/skills/x-article-publisher/scripts/`:

### parse_markdown.py
Parse Markdown and extract structured data:
```bash
python parse_markdown.py <markdown_file> [--output json|html] [--html-only]
```
Returns JSON with: title, cover_image, content_images, **dividers** (with block_index for positioning), html, total_blocks

### copy_to_clipboard.py
Copy image or HTML to system clipboard (cross-platform):
```bash
# Copy image (with optional compression)
python copy_to_clipboard.py image /path/to/image.jpg [--quality 80]

# Copy HTML for rich text paste
python copy_to_clipboard.py html --file /path/to/content.html
```

Report a problem

Foxx AIX Article Publisher
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.