Agent skill

X Article Publisher

by anbeime in anbeime/skill

自媒体创作者与内容创作者在需要将 Markdown 长文发布到 X (Twitter) Articles 编辑器时使用。技能自动将 Markdown 转换为富文本并完美保留排版,支持持久化免密登录与封面上传,一键完成发布,大幅提升长文分发效率。

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 .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
16 (incl. scripts)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

自媒体创作者与内容创作者在需要将 Markdown 长文发布到 X (Twitter) Articles 编辑器时使用。技能自动将 Markdown 转换为富文本并完美保留排版,支持持久化免密登录与封面上传,一键完成发布,大幅提升长文分发效率。

  • 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) Articles 编辑器时使用。技能自动将 Markdown 转换为富文本并完美保留排版,支持持久化免密登录与封面上传,一键完成发布,大幅提升长文分发效率。

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

It sits in Documents & Office, covering Markdown. It works with X (Twitter) 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 36 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
~36
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,357 tokens.

Download SKILL.mdSave it as .claude/skills/x-article-publisher/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
x-article-publisher
description
自媒体创作者与内容创作者在需要将 Markdown 长文发布到 X (Twitter) Articles 编辑器时使用。技能自动将 Markdown 转换为富文本并完美保留排版,支持持久化免密登录与封面上传,一键完成发布,大幅提升长文分发效率。

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 --headless

# 自定义标题
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 15 other files (scripts) in skills/qiaomu-x-article-publisher of anbeime/skill.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • LICENSE
  • README.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
Publish X Articlesugarforever/01coder-agent-skills137—~5kAutomated safety check: PassMIT
Markdown to HTML ReportMegaSuperKitty/WeClaw370—~456Automated safety check: PassMIT
Markdown to Word Convertercat-xierluo/SuitAgent205—~559Automated safety check: PassMIT
Doc Cleanernotoriouslab/doc-cleaner309—~712Automated safety check: PassMIT

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
  • Publish X Article

    sugarforever/01coder-agent-skills

    Publishes a Markdown file or URL to the X Articles editor with formatting kept, turning tables, mermaid diagrams and deep headers that X cannot show into images.

    137 GitHub stars~5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Markdown to HTML Report

    MegaSuperKitty/WeClaw

    Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows.

    370 GitHub stars~456 tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Markdown to Word Converter

    cat-xierluo/SuitAgent

    Converts Markdown files into Word documents formatted to Chinese typesetting conventions, with presets for academic, legal, report and book layouts.

    205 GitHub stars~559 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Doc Cleaner

    notoriouslab/doc-cleaner

    Convert PDF, DOCX, XLSX, and text files to clean, structured Markdown.

    309 GitHub stars~712 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

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

    123 GitHub stars~504 tokensUpdated 16 days ago
    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) Articles 编辑器时使用。技能自动将 Markdown 转换为富文本并完美保留排版,支持持久化免密登录与封面上传,一键完成发布,大幅提升长文分发效率。. 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 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 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), Publish X Article (sugarforever/01coder-agent-skills, 137 stars), Markdown to HTML Report (MegaSuperKitty/WeClaw, 370 stars) and Markdown to Word Converter (cat-xierluo/SuitAgent, 205 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.