tool-x-article-publisher

Community

Publish X Articles drafts from Markdown.

AuthorHeyvhuang
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

Pillowpyobjc-framework-Cocoa

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: tool-x-article-publisher
Download link: https://github.com/Heyvhuang/ship-faster/archive/main.zip#tool-x-article-publisher

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.