publish-x-article_skill

Overview

This skill publishes Markdown articles to X (formerly Twitter) Articles editor, preserving formatting and handling X subscription limitations. It converts unsupported elements (tables, mermaid diagrams, deep headers) into images, uploads cover art, and automates pasting rich HTML into the editor. The workflow produces an adapted copy and saves a draft; it never auto-publishes.

How this skill works

First, the skill asks and remembers the user’s X subscription type (Premium or Premium+) to decide how to adapt the Markdown. It scans the file or URL, converts tables and mermaid diagrams to PNGs, flattens or promotes deep headers per subscription rules, then runs a parser to produce title, HTML, image list, dividers, and block indexes. Finally it automates the X Articles editor: uploads cover image, pastes HTML, inserts images and dividers at specified block_index positions, and saves a draft.

When to use it

• You have a Markdown article and want it published to X Articles with preserved formatting.
• You need automatic conversion of tables, mermaid diagrams, or deep headers for X’s limitations.
• You want cover image upload and image placement handled precisely by block index.
• You need an adapted copy saved while preserving the original file.
• You prefer the article saved as a draft (no auto-publish).

Best practices

• Answer the subscription prompt (Premium vs Premium+) at the start; the skill will remember it for the session.
• Pre-process locally: run table/mermaid conversions and review the adapted markdown copy before automation.
• Use the provided parse_markdown.py to get title, html, content_images (with block_index), dividers, and total_blocks.
• Insert images in descending block_index order to avoid position shifts after each insertion.
• Keep browser login to X active before automation and save the adapted markdown alongside the original so changes are auditable.

Example use cases

• Publish a technical blog post with code blocks and tables to X while converting tables to images for Premium accounts.
• Convert a Markdown file containing mermaid diagrams into a rich-drafted X Article with diagrams rendered as PNGs.
• Batch-prepare and upload an article that includes multiple inline images and dividers positioned exactly where intended.
• Adapt an article with deep nested headers so it reads naturally on X Premium by promoting or converting H3+ to bold lead-ins.