tool-x-article-publisher

Convert Markdown to HTML and paste rich text into X Article drafts.

339|58|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/Heyvhuang/ship-faster --skill tool-x-article-publisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-x-article-publisher
Source: https://github.com/Heyvhuang/ship-faster/tree/main/skills/tool-x-article-publisher
Command: npx skills add https://github.com/Heyvhuang/ship-faster --skill tool-x-article-publisher

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 preparing and drafting articles for X Articles by converting Markdown into HTML, pasting rich text, and deterministically inserting images, while ensuring the post remains a draft for manual publishing.

Core Features & Use Cases

  • Markdown → HTML conversion with preservation of headings, bold, links, and lists for X Articles.
  • Deterministic image placement: insert images at precise positions based on a block index.
  • Draft-only publishing: create drafts in X Articles and require user review before publish.
  • Use Case: Content teams can convert internal Markdown docs into X Articles drafts for social distribution.

Quick Start

  1. Ensure Python 3.9+ and macOS (recommended for clipboard features).
  2. Run:
    • python ~/.claude/skills/tool-x-article-publisher/scripts/parse_markdown.py /path/to/article.md > /tmp/x_article.json
    • python ~/.claude/skills/tool-x-article-publisher/scripts/parse_markdown.py /path/to/article.md --html-only > /tmp/x_article.html
  3. Copy HTML to clipboard:
    • python ~/.claude/skills/tool-x-article-publisher/scripts/copy_to_clipboard.py html --file /tmp/x_article.html
  4. Open X Articles and follow the Runbook to paste content and insert images deterministically.

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 convert Markdown to HTML for X Articles drafts?

To convert Markdown to HTML for X Articles drafts, this skill parses Markdown files and preserves headings, bold text, links, and lists into structured HTML. It outputs a JSON file or raw HTML ready for clipboard pasting into X Articles.

Can I insert images deterministically when publishing X Articles from Markdown?

Yes, you can insert images deterministically when publishing X Articles from Markdown by specifying a block index. This ensures images are placed at precise positions within the formatted HTML content during the draft creation process.

Do I need macOS and Python to automate X Articles drafting?

Yes, you need macOS and Python 3.9+ to automate X Articles drafting. The skill requires macOS for clipboard features and depends on Python libraries like Pillow and pyobjc-framework-Cocoa for HTML conversion and image processing.

What is the best way to automate drafting X Articles with rich text formatting?

The best way to automate drafting X Articles with rich text formatting is converting Markdown to HTML and pasting it via clipboard operations. This approach preserves formatting and creates drafts requiring manual review before final publishing.

Does this X Articles automation tool publish content directly without review?

No, this X Articles automation tool does not publish content directly without review. It creates draft posts by pasting rich text, ensuring content remains unpublished until the user manually reviews and publishes it on X Articles.