Agent skill

X Article Publisher

by anbeime in anbeime/skill

内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。

MITAuto-check passedDocuments & Office

Install X Article Publisher

skills CLI
$ npx skills add anbeime/skill --skill x-article-publisher -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install anbeime/skill x-article-publisher --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/anbeime/skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github .claude/skills/x-article-publisher && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-article-publisher
GitHub stars
7.8k
Token cost
~1.4k tokens
SKILL.md length
313 words
Files
18 (incl. scripts)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。

  • Works in 5 steps: ✅ 浏览器窗口自动打开 X 登录页面 → 🔐 手动登录你的 X 账号(需 Premium+ 订阅) → ✅ 完成 2FA 验证(如已启用) → …
  • Tasks that involve Markdown
  • SKILL.md covers Prerequisites, 🎉 首次使用:一次认证,告别重复登录, Scripts and Workflow (简化版), plus 5 more sections
  • Runs Python scripts from its folder; calls python and pip

What it does

X Article Publisher is an agent skill from anbeime/skill. 内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts (for example `CHANGELOG.md`, `CONTRIBUTING.md` and `README.md`).

It sits in Documents & Office, covering Markdown. It works with X (Twitter), GitHub and Python. The repository describes itself as: 收录最全、更新最快的技能Skills商店:精选原创技能包(涵盖文档处理、内容创作、编程开发、机器学习、自动化工作流),全部打包好可直接安装使用!同时自动抓取GitHub上万个Skills项目,按分类、更新时间、Star数量整理。The most comprehensive and frequently updated AI Agent skill… The licence is MIT.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “/x-article-publisher”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. ✅ 浏览器窗口自动打开 X 登录页面
  2. 🔐 手动登录你的 X 账号(需 Premium+ 订阅)
  3. ✅ 完成 2FA 验证(如已启用)
  4. 🏠 登录成功后自动跳转到 Home 时间线
  5. 💾 认证状态自动保存(有效期 7 天)

What it can do on your machine

Read from SKILL.md and the folder at commit db1e192. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 7 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Article Publisher loads about 1.4k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 313 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from anbeime/skill at commit db1e192, republished under its MIT licence (© anbeime). 313 words, ~1,353 tokens.

Download SKILL.mdSave it as .claude/skills/x-article-publisher/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.
name
x-article-publisher
description
内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。

X Article Publisher

Publish Markdown content to X (Twitter) Articles editor, preserving formatting with rich text conversion.

Prerequisites

  • X Premium Plus subscription
  • Python 3.9+ with dependencies: pip install Pillow pyobjc-framework-Cocoa patchright

🎉 首次使用:一次认证,告别重复登录

X Article Publisher 现在支持持久化认证,无需每次手动登录!

🔧 初始化认证(仅需一次)

首次使用前,运行认证设置:

bash
cd ~/.claude/skills/x-article-publisher/scripts
python auth_manager.py setup

流程:

  1. ✅ 浏览器窗口自动打开 X 登录页面
  2. 🔐 手动登录你的 X 账号(需 Premium+ 订阅)
  3. ✅ 完成 2FA 验证(如已启用)
  4. 🏠 登录成功后自动跳转到 Home 时间线
  5. 💾 认证状态自动保存(有效期 7 天)
📋 认证管理命令
bash
# 检查认证状态
python auth_manager.py status

# 验证认证是否有效
python auth_manager.py validate

# 清除认证数据(需重新登录)
python auth_manager.py clear

# 重新认证(清除 + 设置)
python auth_manager.py reauth
🚀 自动化工作流

认证设置完成后,skill 执行时会自动:

  1. ✅ 检查认证状态
  2. 🔓 如已认证,直接使用保存的浏览器状态(无需登录)
  3. ⚠️ 如未认证,提示运行 auth_manager.py setup

注意:认证数据存储在 ~/.claude/skills/x-article-publisher/data/browser_state/,已通过 .gitignore 排除,不会提交到 Git。


Scripts

Located in ~/.claude/skills/x-article-publisher/scripts/:

publish_article.py (主脚本 - 一键发布)

推荐使用 - 自动完成所有发布步骤:

bash
# 基本用法
python publish_article.py --file article.md

# 显示浏览器(调试用)
python publish_article.py --file article.md --show-browser

# 自定义标题
python publish_article.py --file article.md --title "自定义标题"
parse_markdown.py

Parse Markdown and extract structured data:

bash
python parse_markdown.py <markdown_file> [--output json|html] [--html-only]

Returns JSON with: title, cover_image, content_images (with block_index for positioning), html, total_blocks

copy_to_clipboard.py

Copy image or HTML to system clipboard:

bash
# Copy image (with optional compression)
python copy_to_clipboard.py image /path/to/image.jpg [--quality 80]

# Copy HTML for rich text paste
python copy_to_clipboard.py html --file /path/to/content.html

Workflow (简化版)

前提:已完成认证设置(python auth_manager.py setup)

🚀 一键发布(推荐)

直接运行 publish_article.py,自动完成所有步骤:

bash
cd ~/.claude/skills/x-article-publisher/scripts
python publish_article.py --file /path/to/article.md

脚本会自动:

  1. ✅ 检查认证状态
  2. 📄 解析 Markdown 文件
  3. 🌐 启动已认证的浏览器
  4. 📍 导航到 X Articles 编辑器
  5. 🔘 点击 create 按钮
  6. 🖼️ 上传封面图(如有)
  7. 📝 填写标题
  8. 📋 粘贴 HTML 内容
  9. ✅ 保存草稿(不会自动发布)
手动工作流(高级用户)

如需更精细控制,可分步执行:

  1. Parse Markdown: python parse_markdown.py article.md
  2. 手动操作浏览器发布

🧠 智能增强功能

智能标题生成

当文章没有 H1 标题时,parse_markdown.py 会返回 needs_title_generation: true。

Claude 应该自动:

  1. 阅读文章内容,理解核心观点
  2. 生成一个吸引人点击的标题(15-25字为佳)
  3. 使用 --title "生成的标题" 参数发布

好标题的特点:

  • 包含数字或具体细节("3个方法"、"90%的人不知道")
  • 激发好奇心("为什么..."、"如何..."、"...的真相")
  • 与读者切身相关
  • 避免标题党,但要有吸引力

示例:

bash
# 解析文章
python parse_markdown.py article.md

# 如果 needs_title_generation: true,Claude 生成标题后:
python publish_article.py --file article.md --title "AI时代,普通人的3个生存法则"
智能封面图生成

当文章没有封面图时,parse_markdown.py 会返回 needs_cover_generation: true。

Claude 应该自动:

  1. 阅读文章,提炼核心概念(1-3个关键词)
  2. 调用 gemini-image-generator 或 jimeng-image-generator skill 生成封面图
  3. 封面图风格建议:
    • 简洁大气,避免复杂细节
    • 可以是抽象概念的可视化
    • 或是带有核心关键词的文字海报
  4. 将生成的图片路径插入到文章开头作为封面

封面图生成提示词模板:

为一篇关于「{文章主题}」的文章生成封面图。
风格:简洁、现代、科技感
元素:{1-3个核心视觉元素}
文字:可选,如果加文字只放{1-3个关键词}
尺寸:16:9 横版

工作流示例:

bash
# 1. 解析文章
python parse_markdown.py article.md
# 输出: needs_cover_generation: true

# 2. Claude 调用生图 skill 生成封面(假设保存到 /tmp/cover.png)

# 3. 将封面图插入文章开头,或手动上传

注意:封面图上传目前需要在浏览器中手动操作,脚本会打开编辑器后等待用户操作。


技术细节

parse_markdown.py 输出格式
json
{
  "title": "Article Title",
  "title_source": "h1",           // "h1", "h2", "first_line", or "none"
  "needs_title_generation": false, // true if no H1 title
  "cover_image": "/path/to/first-image.jpg",
  "needs_cover_generation": false, // true if no cover image
  "content_images": [
    {"path": "/path/to/img2.jpg", "block_index": 5}
  ],
  "html": "<p>Content...</p><h2>Section</h2>...",
  "total_blocks": 45
}

字段说明:

  • title_source: 标题来源
    • h1: 来自 H1 标题(最理想)
    • h2: 来自第一个 H2 标题
    • first_line: 来自第一行文本
    • none: 无法提取标题
  • needs_title_generation: 是否需要 Claude 生成更好的标题
  • needs_cover_generation: 是否需要 Claude 生成封面图

Critical Rules

  1. NEVER auto-publish - Only save as draft
  2. NO automatic cover images - User adds cover manually, never insert first image as cover
  3. Clean placeholders - Remove all remaining @@@IMG_X@@@ markers after image insertion
  4. H1 title handling - H1 is used as title only, not included in body

Supported Formatting

  • H2 headers (## )
  • Blockquotes (> )
  • Code blocks (converted to blockquotes)
  • Bold text (**)
  • Hyperlinks (text)
  • Ordered/Unordered lists
  • Paragraphs

Example

User: "Publish /path/to/article.md to X"

bash
cd ~/.claude/skills/x-article-publisher/scripts
python publish_article.py --file /path/to/article.md

Output:

📄 解析文件:/path/to/article.md
  📝 标题:文章标题
  🖼️  封面图:/path/to/cover.jpg
  📷 内容图:2 张

🌐 启动浏览器...
  📍 导航到 X Articles...
  🔘 点击 create 按钮...
  📝 填写标题...
  📋 粘贴内容...

✅ 草稿已创建!
  💡 请在浏览器中检查并手动发布
  🖥️  浏览器保持打开,请检查草稿并手动发布
  ⏎  完成后按回车键关闭浏览器...

技术经验参考: 浏览器自动化调试技巧详见 skill-development-guide

© anbeime, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 17 other files (scripts) in skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github of anbeime/skill.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • CONTRIBUTING.md
  • LICENSE
  • README.md
  • README_FULL.md
  • data/.gitignore
  • data/.gitkeep
  • data/browser_state/.gitkeep
  • metadata.json
  • scripts/auth_manager.py
  • scripts/copy_to_clipboard.py
  • scripts/debug_editor.py
  • scripts/debug_page.py
  • scripts/parse_markdown.py
  • scripts/publish_article.py
  • scripts/site_config.py

Open the folder on GitHubat commit db1e192

Compare with similar skills

X Article Publisher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Article Publisher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Article Publisher this skillanbeime/skill7.8k—~1.4kAutomated safety check: PassMIT
X Article Publisherwshuyi/x-article-publisher-skill8722 repos~3.6kAutomated safety check: PassMIT
Lov Any2pdflovstudio/any2pdf211—~2.4kAutomated safety check: NotesMIT
PullmdAeternaLabsHQ/pullmd486—~2.6kAutomated safety check: PassAGPL-3.0
MineruNebutra/MinerU-Skill123—~1.4kAutomated safety check: PassMIT
Markdown Exporterbowenliang123/markdown-exporter2721 repos~5.3kAutomated safety check: PassApache-2.0

Similar skills

  • X Article Publisher

    wshuyi/x-article-publisher-skill

    Publish Markdown articles to X (Twitter) Articles editor with proper formatting.

    872 GitHub starsUsed in 2 repos~3.6k tokens
    Documents & OfficeAuto-check passed
  • Lov Any2pdf

    lovstudio/any2pdf

    Convert Markdown documents to professionally typeset PDF files with reportlab.

    211 GitHub stars~2.4k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Pullmd

    AeternaLabsHQ/pullmd

    Read any web page, document, or YouTube video as clean Markdown using PullMD.

    486 GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~1.4k tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed
  • Markdown Exporter

    bowenliang123/markdown-exporter

    Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.

    272 GitHub starsUsed in 1 repo~5.3k tokens
    Documents & OfficeAuto-check passed
  • Markdown Converter

    Team-Commonly/commonly

    Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.

    1.4k GitHub stars~557 tokensUpdated today
    Documents & OfficeAuto-check passed

More from anbeime/skill

All 62 skills in this repo
  • Chinese-language skill that produces a 25-second vertical video of a digital shopping-guide avatar for e-commerce, chaining AI image, voice and video generation.

    7.8k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Produces a full material pack for a three-minute history-of-science explainer video from a theme, era and core conclusion: narration, storyboard, Veo2 prompts and character design.

    7.8k GitHub stars~480 tokensUpdated yesterday
    Auto-check passed
  • Turns a PPT content outline into styled slide images, an interactive HTML viewer and an optional stitched video from a content-planning partner skill.

    7.8k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check: notes
  • Builds or improves a PowerPoint deck through a seven-role workflow: topic analysis, template choice, content planning, writing, image suggestions, editing and PPTX generation.

    7.8k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Turns a document into a narrated roadshow video through ten staged roles, from document analysis and slide planning to audio, subtitles and final composition.

    7.8k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check: notes
  • PPTX Generator

    anbeime/skill

    产品经理与运营专员在准备汇报展示时,将 JSON 数据一键转换为标准 .pptx 文件。自动应用多种布局、图表与表格样式,快速生成专业 PPT,彻底告别繁琐手工排版,让内容产出与展示更高效!

    7.8k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Questions about X Article Publisher

What does X Article Publisher do?

内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。. X Article Publisher is an agent skill from anbeime/skill.

When should I use X Article Publisher?

X Article Publisher fits situations like: tasks that involve Markdown.

How do I install X Article Publisher in Claude Code?

Run `npx skills add anbeime/skill --skill x-article-publisher -a claude-code`. Or copy the skill folder (skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github in anbeime/skill) into .claude/skills/x-article-publisher in your project. Claude Code loads it when a task matches its description.

How do I install X Article Publisher in Codex?

Run `npx skills add anbeime/skill --skill x-article-publisher -a codex`. Or copy the skill folder (skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github in anbeime/skill) into .agents/skills/x-article-publisher in your project. Codex loads it when a task matches its description.

Can I use X Article Publisher in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add anbeime/skill --skill x-article-publisher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-article-publisher, .gemini/skills/x-article-publisher, .github/skills/x-article-publisher and .opencode/skills/x-article-publisher in your project.

What does X Article Publisher need to run?

Going by SKILL.md and its folder, X Article Publisher needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does X Article Publisher access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is X Article Publisher safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does X Article Publisher use?

X Article Publisher is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Article Publisher use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to X Article Publisher?

Skills that share tags, products or a category with X Article Publisher: X Article Publisher (wshuyi/x-article-publisher-skill, 872 stars), Lov Any2pdf (lovstudio/any2pdf, 211 stars), Pullmd (AeternaLabsHQ/pullmd, 486 stars) and Mineru (Nebutra/MinerU-Skill, 123 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Article Publisher?

anbeime (a GitHub user) maintains it in anbeime/skill, which has 7,760 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on October 9, 2026.

Source: anbeime/skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.