Agent skill

X Article Draft Uploader

by mcncarl in mcncarl/yichen-skills

将 Obsidian 或本地 Markdown 文章上传到 X/Twitter Articles 草稿;支持 Markdown pipe 表格转成 X 原生表格块;如果文章最上方有图片,则按当前 X 界面提示的 5:2 封面图上传;如果没有封面图,则跳过封面区域,直接上传标题、正文、表格和正文图片,完成后提醒用户补一张 5:2 封面。X Article 当前实测正文最多 25…

Custom licenceAuto-check: warningsWriting & Content

Install X Article Draft Uploader

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add mcncarl/yichen-skills --skill x-article-draft-uploader -a claude-code

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

GitHub CLI
$ gh skill install mcncarl/yichen-skills x-article-draft-uploader --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/mcncarl/yichen-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/yichen-x-article-draft-uploader .claude/skills/x-article-draft-uploader && 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-draft-uploader
GitHub stars
4.3k
Token cost
~2.9k tokens
SKILL.md length
818 words
Files
13 (incl. scripts)
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

将 Obsidian 或本地 Markdown 文章上传到 X/Twitter Articles 草稿;支持 Markdown pipe 表格转成 X 原生表格块;如果文章最上方有图片,则按当前 X 界面提示的 5:2 封面图上传;如果没有封面图,则跳过封面区域,直接上传标题、正文、表格和正文图片,完成后提醒用户补一张 5:2 封面。X Article 当前实测正文最多 25…

  • Works in 12 steps: 使用本 Skill 自带的 scripts/parse_markdown.py… → 执行 preflight。正文图片文件、图片数量、图片锚点问题必须在打开 X… → 核算正文媒体:expected_body_images 必须小于或等于… → …
  • Tasks that involve Blog and article writing
  • SKILL.md covers 许可与商业授权, 核心原则, 快速开始 and 操作流程, plus 2 more sections
  • Runs Python scripts from its folder; calls python3; reaches x.com

What it does

X Article Draft Uploader is an agent skill from mcncarl/yichen-skills. 将 Obsidian 或本地 Markdown 文章上传到 X/Twitter Articles 草稿;支持 Markdown pipe 表格转成 X 原生表格块;如果文章最上方有图片,则按当前 X 界面提示的 5:2 封面图上传;如果没有封面图,则跳过封面区域,直接上传标题、正文、表格和正文图片,完成后提醒用户补一张 5:2 封面。X Article 当前实测正文最多 25 个媒体项,封面单独上传且不占正文名额;表格尺寸选择器当前最大 10 x 10。适用于用户要求上传、发布、保存 Markdown 到 X Article,尤其是需要复用 Chrome 登录态、使用独立 Playwright 浏览器、不接管用户当前浏览器,或旧脚本出现缺图、错位、MPHMARKER、表格变纯文本等问题时。

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including scripts (for example `README.md`, `agents/openai.yaml` and `examples/smoke-test.md`).

It sits in Writing & Content, covering Blog and article writing, Browser testing and Markdown. It works with Playwright, Obsidian and X (Twitter).

When your agent uses it

  • Tasks that involve Blog and article writing
  • Tasks that involve Browser testing
  • Tasks that involve Markdown

Example prompts

  • “/x-article-draft-uploader”

Requirements

  • Python 3

Workflow steps

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

  1. 使用本 Skill 自带的 scripts/parse_markdown.py 解析 Markdown。
  2. 执行 preflight。正文图片文件、图片数量、图片锚点问题必须在打开 X 之前解决;缺少置顶封面只作为 warning,不阻断上传。
  3. 核算正文媒体:expected_body_images 必须小于或等于 25,封面单独上传、不占正文名额。超过 25 张正文图时,先制作临时上传版,合并连续截图或拆分文章,并重新 dry-run 到 25 以内。
  4. 核算表格:expected_tables 可以大于 0,但每张表必须在 10 x 10 以内。表格上传必须走 X 原生表格块,不要只粘贴 HTML,也不要接受表格被压成普通文本。
  5. 如果文章最开头的第一张图片存在,把它当作 5:2 封面图;如果文章不是以图片开头,不要自动挑正文图做封面,而是把所有图片按正文图处理。
  6. 从原始 Markdown 中读取每张正文图前一行,作为图片插入锚点。图片必须按 Markdown 原始 destination 解析后的完整规范路径与 occurrence 定位,不能只按 basename…
  7. 启动全新的 Playwright Chromium context,并添加 X cookies。
  8. 打开 https://x.com/compose/articles,点击 create,记录新生成的 /compose/articles/edit/... URL。
  9. 如果有封面图,通过封面区域的 file input 上传封面,然后点击 X 的 应用。如果没有封面图,直接跳过封面上传,保持封面区域空白。
  10. 填写标题,并把 rich HTML 正文粘贴到 [data-testid="composer"]。正文里的 Markdown 表格位置此时会是临时 X_TABLE_MARKER_*。
  11. 对每张表格按正文顺序处理:定位 X_TABLE_MARKER_*,删除占位符,点击 插入 -> 表格,选择对应行列,打开表格块右上角铅笔,把原始 Markdown 表格写入文本框,点击 更新。
  12. 正文图片从后往前插入。每张图都按这个顺序处理

What it can do on your machine

Read from SKILL.md and the folder at commit 9bd7898. 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 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • x.com

    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 Draft Uploader loads about 2.9k tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 818 words of instructions outside code blocks.

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

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: warnings

The automated check found patterns that need a careful read before installing.

  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:89
    7. 启动全新的 Playwright Chromium context,并添加 X cookies。
  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:142
    - cookie 导出脚本只读取本机 Chrome cookies,并把指定输出原子写成 `0600`;规范路径

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 818 words (~2,854 tokens).

“本 Skill 仅允许个人学习、研究和非商业个人工作流使用。客户交付、付费产品或服务、 公司内部部署、市场打包、课程打包及其他商业用途,必须事先取得作者明确的书面授权。 申请商业授权请添加微信 yichen365ai,并在验证信息中备注 商业授权;收到明确书面 授权前不得商用。完整条款见同目录 LICENSE。该限制只适用于本 Skill, 不改变 Ailu 核心的 AGPL-3.0-or-later 许可;第三方材料继续适用各自许可证。”

— opening of SKILL.md by mcncarl, Custom licence
name
x-article-draft-uploader

Read the full SKILL.md on GitHub

Files

SKILL.md and 12 other files (scripts) in yichen-x-article-draft-uploader of mcncarl/yichen-skills.

  • SKILL.md
  • LICENSE
  • README.md
  • VERSION
  • agents/openai.yaml
  • examples/smoke-test.md
  • requirements.txt
  • scripts/export_x_cookies_from_chrome.py
  • scripts/parse_markdown.py
  • scripts/upload_markdown_to_x_article.py
  • tests/anchor_normalization_vectors.json
  • tests/test_cookie_exporter.py
  • tests/test_local_contracts.py

Open the folder on GitHubat commit 9bd7898

Compare with similar skills

X Article Draft Uploader 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 Draft Uploader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Article Draft Uploader this skillmcncarl/yichen-skills4.3k—~2.9kAutomated safety check: WarnCustom licence
Publish X Articlesugarforever/01coder-agent-skills136—~5kAutomated safety check: PassMIT
Publish Zsxq Articlesugarforever/01coder-agent-skills136—~3.2kAutomated safety check: PassMIT
Notion To Blogwasp-lang/wasp19k—~922Automated safety check: PassMIT
URL to Markdown Fetcherjoeseesun/qiaomu-markdown-proxy509—~1.4kAutomated safety check: PassMIT
Web Article Extractordongbeixiaohuo/writing-agent434—~740Automated safety check: PassMIT

Similar skills

  • 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.

    136 GitHub stars~5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Publish Zsxq Article

    sugarforever/01coder-agent-skills

    Publish Markdown articles to Zsxq (知识星球) as drafts. An agent skill from sugarforever/01coder-agent-skills.

    136 GitHub stars~3.2k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Notion To Blog

    wasp-lang/wasp

    Transfer a blog post from Notion to the Wasp blog. An agent skill from wasp-lang/wasp.

    19k GitHub stars~922 tokensUpdated today
    Writing & ContentAuto-check passed
  • URL to Markdown Fetcher

    joeseesun/qiaomu-markdown-proxy

    Converts a URL or PDF into clean Markdown, with dedicated routes for WeChat articles, Feishu docs, arXiv papers and login-gated pages, before any summary or rewrite.

    509 GitHub stars~1.4k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Web Article Extractor

    dongbeixiaohuo/writing-agent

    使用隔离的 Chrome DevTools MCP 从博客、新闻、公众号等网页提取正文,返回结构化内容,或保存 Markdown 和远程图片。用户要求提取文章、抓取网页正文、保存为 Markdown、下载文章图片或排查正文选择器时调用。

    434 GitHub stars~740 tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Playwriter

    AgiFlow/aicode-toolkit

    Control the user own Chrome browser via Playwriter extension with Playwright code snippets in a stateful local js sandbox via playwriter cli.

    161 GitHub stars~457 tokensUpdated 3 days ago
    Testing & QAAuto-check passed

More from mcncarl/yichen-skills

All 19 skills in this repo
  • Yichen Asr

    mcncarl/yichen-skills

    逸尘自用的统一音视频转写入口,在 StepFun Step ASR 与火山引擎豆包 ASR 之间按输出需求、安全边界和可用状态路由。用于本地音频或视频的纯文本转写、时间戳、SRT 字幕、口播粗剪,以及转写前体检;用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription and the correct…

    4.3k GitHub stars~780 tokensUpdated 4 days ago
    Auto-check passed
  • Yichen Mac Wechat Dual Open

    mcncarl/yichen-skills

    Create, inspect, repair, and polish a second WeChat app on macOS by copying WeChat, changing the bundle identifier, ad-hoc re-signing, preparing it for the user to open manually, setting Chinese…

    4.3k GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Yichen Web Research

    mcncarl/yichen-skills

    逸尘自用的互联网研究总入口。用于跨平台且跨阶段、用户尚未确定工具,或明确要求对公司、产品、人物、技术、行业和领域做横纵分析、发展史加现状对比或有来源约束的系统深度研究;先生成有截止日期和证据闸门的计划,再把搜索发现、候选核验、有限归档、按需转写和证据综合路由到…

    4.3k GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check passed
  • Yichen Wechat Mp Batch Exporter

    mcncarl/yichen-skills

    批量下载微信公众号文章正文、历史文章列表、原创文章筛选、历史计数口径、阅读量、点赞/转发等指标、评论和评论回复。Use when the user asks to batch fetch mp.weixin.qq.com articles, export WeChat public-account history, distinguish publish groups vs expanded…

    4.3k GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Yichen Wecom Local Vault

    mcncarl/yichen-skills

    Read, decrypt, query, search, and export local WeCom/企业微信 5.x desktop databases on macOS into a private read-only vault.

    4.3k GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed
  • Yichen X Slicer

    mcncarl/yichen-skills

    将公开 X 推文、Quote 或同作者 Thread 转为 1080×1440 图片切片和 MP4;也支持显式 source-only 素材桥接。保留所选原生视频及对应音频,不发布。

    4.3k GitHub stars~2.2k tokensUpdated 4 days ago
    Auto-check passed

Questions about X Article Draft Uploader

What does X Article Draft Uploader do?

将 Obsidian 或本地 Markdown 文章上传到 X/Twitter Articles 草稿;支持 Markdown pipe 表格转成 X 原生表格块;如果文章最上方有图片,则按当前 X 界面提示的 5:2 封面图上传;如果没有封面图,则跳过封面区域,直接上传标题、正文、表格和正文图片,完成后提醒用户补一张 5:2 封面。X Article 当前实测正文最多 25…. X Article Draft Uploader is an agent skill from mcncarl/yichen-skills.

When should I use X Article Draft Uploader?

X Article Draft Uploader fits situations like: tasks that involve Blog and article writing; tasks that involve Browser testing; tasks that involve Markdown.

How do I install X Article Draft Uploader in Claude Code?

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

How do I install X Article Draft Uploader in Codex?

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

Can I use X Article Draft Uploader 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 mcncarl/yichen-skills --skill x-article-draft-uploader -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-draft-uploader, .gemini/skills/x-article-draft-uploader, .github/skills/x-article-draft-uploader and .opencode/skills/x-article-draft-uploader in your project.

What does X Article Draft Uploader need to run?

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

Does X Article Draft Uploader access the network?

SKILL.md names 1 domain. In commands or code: x.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is X Article Draft Uploader safe to install?

Our automated static check of SKILL.md flagged 2 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way. 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 Draft Uploader use?

X Article Draft Uploader has a licence file (from the LICENSE file in the skill folder) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does X Article Draft Uploader use?

About 2.9k tokens (SKILL.md is roughly 11k 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 Draft Uploader?

Skills that share tags, products or a category with X Article Draft Uploader: Publish X Article (sugarforever/01coder-agent-skills, 136 stars), Publish Zsxq Article (sugarforever/01coder-agent-skills, 136 stars), Notion To Blog (wasp-lang/wasp, 19k stars) and URL to Markdown Fetcher (joeseesun/qiaomu-markdown-proxy, 509 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Article Draft Uploader?

mcncarl (a GitHub user) maintains it in mcncarl/yichen-skills, which has 4,331 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 4, 2026.

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