Tool X Article Publisher
Apps & Automationtool-x-article-publisherTool X Article Publisher is an Agent Skill for apps & automation published in the Heyvhuang/ship-faster repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Publish Markdown to X (Twitter) Articles as a draft (never auto-publish). Use when the user asks to publish/post an article to X Articles, convert Markdown to X Articles rich text, or mentions "X article", "publish to X", "post to Twitter articles". Converts Markdown → HTML, pastes rich text, and inserts images deterministically.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Heyvhuang/ship-faster/blob/HEAD/legacy/skills/tool-x-article-publisher/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tool-x-article-publisher, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
X Article Publisher
Publish Markdown content into X (Twitter) Articles as a draft, preserving formatting via rich text paste and deterministic image insertion.
Hard Rules (Safety)
- Never auto-publish (draft only; user publishes manually).
- User must be logged in before automation starts.
- First image = cover image (if any).
Prerequisites
- Browser automation available (Playwright MCP or equivalent)
- X account can access Articles (Premium / Premium Plus)
- macOS recommended (clipboard helper uses Cocoa)
- Python 3.9+ with:
pip install Pillow pyobjc-framework-Cocoa
Inputs / Outputs (Recommended)
Inputs (paths only):
article_md_path: Markdown file to publish- Optional:
run_dirfor artifacts (otherwise use/tmp/)
Outputs (recommended artifacts):
/tmp/x_article.json(parsed structure)/tmp/x_article.html(HTML body for paste)- Optional:
run_dir/evidence/x-article-draft.md(what was done + links)
Bundled Scripts
Installed path (typical):
~/.claude/skills/tool-x-article-publisher/scripts/parse_markdown.py~/.claude/skills/tool-x-article-publisher/scripts/copy_to_clipboard.py
Runbook (Step-by-step)
Follow: references/runbook.md