tool-x-article-publisher

Convert Markdown files to X (Twitter) Article drafts with deterministic image placement.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/mshaheerz/hive-mind --skill tool-x-article-publisher-mshaheerz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-x-article-publisher
Source: https://github.com/mshaheerz/hive-mind/tree/main/agent-skills/tool-x-article-publisher
Command: npx skills add https://github.com/mshaheerz/hive-mind --skill tool-x-article-publisher-mshaheerz

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of publishing Markdown content to X (Twitter) Articles, ensuring formatting is preserved and images are correctly placed, while strictly adhering to draft-only publication.

Core Features & Use Cases

  • Markdown to X Article Conversion: Converts Markdown files into rich text suitable for X Articles.
  • Deterministic Image Handling: Inserts images at precise locations within the article based on their original block index.
  • Draft-Only Publication: Guarantees that articles are saved as drafts, preventing accidental auto-publishing.
  • Use Case: You have a blog post written in Markdown that you want to share as an X Article. This Skill will convert it, handle all images, and save it as a draft for your final review and manual publishing.

Quick Start

Use the tool-x-article-publisher skill to publish the markdown file located at /path/to/your/article.md as a draft on X Articles.

Frequently Asked Questions about tool-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 as a draft?

To publish Markdown to X Articles as a draft, this Skill converts your Markdown content to HTML and handles deterministic image insertion based on block index. It uses Playwright browser automation to save the article strictly as a draft for manual review.

Does publishing Markdown to X Articles preserve my image positions?

Yes, publishing Markdown to X Articles preserves image positions through deterministic image handling. The Skill inserts images at precise locations within the article based on their original block index defined in the Markdown file.

Do I need Python and Playwright to convert Markdown to X Articles?

Yes, you need Python with specific libraries like Pillow and pyobjc-framework-Cocoa for clipboard operations and image handling on macOS. The Skill also supports browser automation via Playwright to interact with the X Articles publishing interface.

Can I automatically publish X Articles without manual review?

No, this Skill strictly adheres to draft-only publication to prevent accidental auto-publishing. It guarantees articles are saved as drafts, requiring you to manually review and publish the converted Markdown content on X.

Why does Markdown to X Article conversion require macOS specific dependencies?

Markdown to X Article conversion requires macOS specific dependencies like pyobjc-framework-Cocoa and Pillow to handle clipboard operations and image processing. These libraries enable deterministic image insertion during the Playwright browser automation phase.