md-to-x-article-skill

A portable Agent Skill that converts Markdown long-form content into a polished X Article publishing draft.

What It Does

• Preserves the author's meaning, facts, links, and rich media positions
• Optimizes headings, paragraphs, lists, quotations, and emphasis for mobile reading
• Converts Markdown tables into readable lists
• Produces an edited Markdown draft and a copy-ready rich-text HTML preview
• Identifies images, videos, GIFs, and X posts that must be added natively in the X Article editor
• Validates formatting, links, media references, and content consistency before delivery

Compatibility

This repository follows the open Agent Skills specification. It contains a root-level SKILL.md and does not depend on a specific agent, tool API, script runtime, or installation path.

Use it with any agent that supports the Agent Skills open format. Installation and discovery locations vary by agent.

Use

Ask a compatible agent to convert a Markdown document into X Article format, for example:

Use $md-to-x-article-skill to convert this Markdown into an X Article.

The skill creates:

• x-article-ready.md
• x-article-ready.html

Open the HTML file in a browser, copy the formatted article into the X Article editor, then upload or embed rich media natively in X.