x-article-publisher

Publish Markdown articles to X Articles with image uploads.

35|10|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/ttmouse/skills --skill x-article-publisher-ttmouse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-article-publisher
Source: https://github.com/ttmouse/skills/tree/main/x-article-publisher
Command: npx skills add https://github.com/ttmouse/skills --skill x-article-publisher-ttmouse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, pyobjc-framework-Cocoa, pywin32, clip-util, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of publishing Markdown articles to X (Twitter) Articles, ensuring proper formatting and handling of images.

Core Features & Use Cases

  • Markdown to Rich Text Conversion: Automatically converts Markdown formatting (headers, bold, links, lists) into X's rich text editor format.
  • Automated Image Handling: Uploads cover images and inserts content images at precise locations using block indexing.
  • Use Case: You have a technical blog post written in Markdown. Use this Skill to quickly publish it as a formatted X Article, including all images, without manual copy-pasting or reformatting.

Quick Start

Use the x-article-publisher skill to publish the markdown file '~/my-article.md' to X.

Frequently Asked Questions about x-article-publisher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Markdown file to X Articles?

Publishing Markdown to X Articles requires converting formatting into the X rich text editor and managing image uploads. This Skill automates that process by translating Markdown syntax and handling cover image insertion.

Does publishing Markdown to X Articles handle image uploads automatically?

Yes, publishing Markdown to X Articles handles image uploads automatically. The Skill uploads cover images and inserts content images at precise locations using block index positioning within the article.

Do I need X Premium Plus to publish articles using Markdown?

Yes, you need X Premium Plus to publish articles using Markdown. The Skill requires the user to be logged into an X Premium Plus account to access and interact with the X Articles editor.

What dependencies are required to convert Markdown for X Articles?

To convert Markdown for X Articles, dependencies required include Playwright MCP for browser automation and specific Python packages like Pillow, pyobjc-framework-Cocoa, pywin32, and clip-util for image and HTML manipulation.

Can I convert Markdown headers and links into X rich text formatting?

Yes, you can convert Markdown headers and links into X rich text formatting. The Skill automatically translates Markdown elements including headers, bold text, links, and lists into the X Article editor's native format.

Why does my Markdown image not upload to the correct location in X Articles?

If a Markdown image does not upload to the correct location in X Articles, it may be due to block indexing positioning. The Skill inserts content images at precise locations using block indexing based on your Markdown structure.