mcpField
P
publish-x-article

publish-x-article

github.com/heyvhuangMarketing & growth33849 installsUpdated 30w ago
Repository

About publish-x-article

publish-x-article is a skill for converting Markdown into an X Articles draft while retaining formatting and placing images predictably. It is intended for users preparing articles for manual publication; the workflow never publishes automatically.

Key features

  1. 01Convert Markdown into article content
  2. 02Preserve formatting through rich-text paste
  3. 03Insert images deterministically
  4. 04Use the first image as the cover
  5. 05Save parsed content and HTML artifacts

Use cases

  1. 01Prepare a Markdown article as an X draft
  2. 02Create an article draft with a cover image
  3. 03Review generated article content before publishing

MCP support

The workflow requires browser automation, such as Playwright MCP or an equivalent, to interact with X Articles. It prepares a draft only; the user publishes it manually.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/heyvhuang/ship-faster --skill publish-x-article

After installing, type/publish-x-articlein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
runbook.md
scripts/
copy_to_clipboard.py
parse_markdown.py

Details

From the project README

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)

  1. Never auto-publish (draft only; user publishes manually).
  2. User must be logged in before automation starts.
  3. 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

Comments

Markdown supported