publish-x-article

Convert Markdown files to X Articles drafts with image insertion.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/mshaheerz/hive-mind --skill publish-x-article-mshaheerz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-x-article
Source: https://github.com/mshaheerz/hive-mind/tree/main/agent-skills/publish-x-article
Command: npx skills add https://github.com/mshaheerz/hive-mind --skill publish-x-article-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 preventing accidental auto-publication.

Core Features & Use Cases

  • Markdown to X Article Conversion: Converts Markdown files into rich text suitable for X Articles.
  • Deterministic Image Insertion: Places images accurately within the article based on their original position in the Markdown.
  • Draft-Only Publishing: Ensures content is saved as a draft, allowing for manual review before public release.
  • Use Case: You've written a technical blog post in Markdown and want to share it as an X Article. This Skill will convert it, handle images, and prepare it as a draft for you to review and publish.

Quick Start

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

Frequently Asked Questions about publish-x-article

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

FAQPage Schema
How do I convert Markdown to X Articles as a draft?

To convert Markdown to X Articles as a draft, this Skill parses Markdown into HTML and automates browser insertion. It ensures your content is saved as a draft without auto-publishing.

Can I automate image insertion when publishing X Articles from Markdown?

Yes, you can automate image insertion when publishing X Articles from Markdown. The Skill deterministically places images based on their original Markdown position using clipboard manipulation.

Do I need browser automation tools to publish Markdown to X Articles?

Yes, you need browser automation tools to publish Markdown to X Articles. The Skill also requires specific Python libraries like Pillow and pyobjc-framework-Cocoa for parsing and clipboard operations.

What is the best way to prevent accidental auto-publication of X Articles?

The best way to prevent accidental auto-publication of X Articles is using a draft-only publishing workflow. This Skill ensures formatted content is saved strictly as a draft for manual review.

Does this Markdown to X Article conversion process preserve formatting integrity?

Yes, the Markdown to X Article conversion process preserves formatting integrity. It converts Markdown files into rich text suitable for X Articles while maintaining the original layout.