qiaomu-x-article-publisher

🥈Silver

Publish Markdown articles to X (Twitter) Articles with one click. Ideal for content creators and operations teams. Integrates with Claude Code Skill for persistent authentication and standalone operation. Works on macOS with Python 3.9+.

7260Updated 2mo ago

Intermediate30min to implementautomation

Saves ~5 min per use

Quick InstallView Source

git clone https://github.com/joeseesun/qiaomu-x-article-publisher.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Prepare your Markdown article. Ensure it includes frontmatter with title, description, and tags. Save it as a `.md` file (e.g., `ai-content-strategy.md`).","tip":"Use a tool like [Obsidian](https://obsidian.md/) or [Typora](https://typora.io/) to write and preview your Markdown before publishing."},{"step":"Install the qiaomu-x-article-publisher skill. Run `pip install qiaomu-x-article-publisher` in your terminal. Verify installation with `qiaomu-x-article-publisher --version`.","tip":"If you’re on macOS, ensure Python 3.9+ is installed. Use `python3 --version` to check."},{"step":"Authenticate with X (Twitter). Run `qiaomu-x-article-publisher auth` and follow the OAuth flow in your browser. For persistent authentication, use the Claude Code Skill integration.","tip":"If using Claude Code, enable the skill in your Claude settings and grant access to your X account."},{"step":"Publish your article. Run `qiaomu-x-article-publisher publish --file ai-content-strategy.md --title \"The Future of AI-Powered Content Creation\" --tags \"AI,Content Strategy,Twitter\"`.","tip":"Add `--dry-run` to preview the output without publishing. Use `--description \"A deep dive into how AI is changing content distribution\"` to customize the meta description."},{"step":"Share your published article. Copy the URL from the output and promote it across your channels (newsletter, LinkedIn, etc.).","tip":"Use the `--pin` flag to pin the article to your X profile automatically."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/joeseesun/qiaomu-x-article-publisher

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Publish the following Markdown article to X (Twitter) Articles as a [TITLE]. Use the filename [FILENAME.md] and include the following frontmatter: title: [TITLE], description: [SHORT_DESCRIPTION], tags: [COMMA_SEPARATED_TAGS]. Format the article with proper Markdown syntax and ensure the first paragraph is a compelling hook. [ARTICLE_MARKDOWN]

Example Output

📢 **Published to X Articles!**

**Title:** The Future of AI-Powered Content Creation
**URL:** https://x.com/i/articles/1234567890
**Stats:** 1,247 views | 47 likes | 12 bookmarks

**Content Preview:**
The rise of generative AI isn’t just changing *what* we create—it’s revolutionizing *how* we distribute content. In 2024, platforms like X Articles are becoming the new battleground for thought leadership, where a single well-structured post can reach 10x more readers than a traditional blog. But here’s the catch: most creators are still treating these platforms like blogs, not social networks. The difference? **Hooks in the first 2 lines.**

**Key Insights:**
1. **Algorithm-Friendly Structure:** X Articles prioritizes posts with clear sections (H2/H3 headers) and bullet points. My draft used 3 H2 headers and 5 bullet lists—resulting in 2x the average engagement.
2. **Metadata Matters:** The frontmatter tags ("AI", "Content Strategy", "Twitter") matched trending topics, pushing the post into the "For You" feed for 3 hours longer than usual.
3. **Visual Breaks:** Added a horizontal rule (---) after the hook and before the conclusion. Readers spent 40% more time scrolling vs. my previous posts without it.

**Next Steps:**
- Share the link in your newsletter with a CTA like: "Want the full template? Reply with ‘TEMPLATE’ and I’ll send it."
- Schedule a follow-up thread in 48 hours teasing a case study (e.g., "How this post got 5K views in 3 days—here’s the breakdown").

**Full Article:** [See attached file or visit the link above]

*Tip: To maximize reach, pin this article to your profile and add it to your Linktree!*