How do I install the Publish X Article skill?

Run npx skillmds@latest add heyvhuang/publish-x-article in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Publish X Article safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Publish X Article?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Publish X Article free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Publish X Article?

heyvhuang (@heyvhuang) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Publish X Article by heyvhuang — Agent Skill

Name: Publish X Article
Author: heyvhuang

Publish X Article

Publish Markdown to X (Twitter) Articles as a draft (never auto-publish). Use when the user asks to publish/post an article to X Articles, convert Markdown to X Articles rich text, or mentions "X article", "publish to X", "post to Twitter articles". Converts Markdown → HTML, pastes rich text, and inserts images deterministically.

heyvhuang 9901543 4 files · 22.0 KB Updated Sep 17, 2026

File contents

X Article Publisher

Publish Markdown content into X (Twitter) Articles as a draft, preserving formatting via rich text paste and deterministic image insertion.

Hard Rules (Safety)

Never auto-publish (draft only; user publishes manually).
User must be logged in before automation starts.
First image = cover image (if any).

Prerequisites

Browser automation available (Playwright MCP or equivalent)
X account can access Articles (Premium / Premium Plus)
macOS recommended (clipboard helper uses Cocoa)
Python 3.9+ with:
- pip install Pillow pyobjc-framework-Cocoa

Inputs / Outputs (Recommended)

Inputs (paths only):

article_md_path: Markdown file to publish
Optional: run_dir for artifacts (otherwise use /tmp/)

Outputs (recommended artifacts):

/tmp/x_article.json (parsed structure)
/tmp/x_article.html (HTML body for paste)
Optional: run_dir/05-final/x-article-draft.md (what was done + links)

Bundled Scripts

Installed path (typical):

~/.claude/skills/publish-x-article/scripts/parse_markdown.py
~/.claude/skills/publish-x-article/scripts/copy_to_clipboard.py

Runbook (Step-by-step)

Follow: references/runbook.md

Frequently asked questions