Agent skill

WeChat Official Account Publisher

by aiworkskills in aiworkskills/wechat-article-skills

Publishes a finished article and its images directly to a WeChat official account through its official API, as a draft or a live broadcast.

Apache-2.0Auto-check passedProductivity & Automation

SKILL.md written in Chinese; this summary is our English description.

Install WeChat Official Account Publisher

skills CLI
$ npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-publish -a claude-code

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

GitHub CLI
$ gh skill install aiworkskills/wechat-article-skills aws-wechat-article-publish --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/aiworkskills/wechat-article-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/aws-wechat-article-publish .claude/skills/aws-wechat-article-publish && 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
aws-wechat-article-publish
GitHub stars
672
Token cost
~1.5k tokens
SKILL.md length
284 words
Files
10 (incl. scripts, references)
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

Publishes a finished article and its images directly to a WeChat official account through its official API, as a draft or a live broadcast.

  • Works in 2 steps: 跑 {python} {baseDir}/scripts/publish.py… → 选定后写 config.yaml 的 wechat_publish_slot:…
  • Publishing a finished WeChat article and its images via the API
  • SKILL.md covers 能力披露(Capabilities), 路由, 配置检查 ⛔ and 脚本与子命令, plus 7 more sections
  • Runs Python scripts from its folder

What it does

It uploads the article's HTML and image files straight to WeChat's servers, exchanging an app id and secret for an access token that is cached in memory only for the process's lifetime and never written to disk; cover and body images go up through the material-upload endpoint while the article body, title and summary go up as a JSON post to the draft or publish endpoint. Credentials come from named slots in a local environment file, and the API host can be repointed at a proxy through a config setting when needed.

Before any upload it runs through a shared first-time setup check across the whole article toolkit, unless the user has explicitly said in writing to skip that check for this run. Oversized images get a compressed copy written alongside the original, which a bundled dependency produces but which the script never cleans up or uploads as the real content image. The documented recommendation is a first run with draft-only publishing to confirm the result before switching to a real broadcast, and a separate full command chains cover upload, body-image upload, draft creation and publishing together depending on configuration.

When your agent uses it

  • Publishing a finished WeChat article and its images via the API
  • Pushing an article into the official account's draft box first
  • Checking the WeChat API credentials and slots before publishing

Example prompts

  • “Push this article to the WeChat draft box first so I can check it.”
  • “Publish this finished article and its cover image to our official account.”
  • “Check which WeChat account slots are missing their app secret.”

Requirements

  • A WeChat official account with API access
  • App id and secret stored in a local environment file
  • Pillow, for compressing oversized images

Workflow steps

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

  1. 跑 {python} {baseDir}/scripts/publish.py accounts,把 config.yaml 的 wechat_accounts + wechat_{i}_name 列给用户(例如「您有 2 个账号:1. xiaoming,2…
  2. 选定后写 config.yaml 的 wechat_publish_slot: <整数>,或命令行 --account <序号或名称>(CLI 优先)。

What it can do on your machine

Read from SKILL.md and the folder at commit ca036f7. 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.

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

  • Network

    No URLs in SKILL.md.

    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

WeChat Official Account Publisher loads about 1.5k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 284 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

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 aiworkskills/wechat-article-skills at commit ca036f7, republished under its Apache-2.0 licence (© aiworkskills). 284 words, ~1,456 tokens.

Download SKILL.mdSave it as .claude/skills/aws-wechat-article-publish/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
aws-wechat-article-publish
description
公众号发布|公众号草稿箱|公众号群发|图文推送|微信 API|wechat automation|WeChat API automation|auto publish|scheduled publish — 公众号 API 发布工具,图文入草稿箱或直接群发,支持封面素材上传、发布前检查与 draft/published 模式切换。面向公众号运营、自动化内容团队、开发者。触发词:「发布」「提交」「群发」「推送」「发出去」「上传到公众号」「发到公众号」「可以发了吗」「发布前检查」。需要多环节串联(写+审+排+配图+发)请走 aws-wechat-article-main。
homepage
https://aiworkskills.cn
url
https://github.com/aiworkskills/wechat-article-skills

发布

公众号 API 直连发布 —— 图文入草稿箱或直接群发,素材上传、发布前检查一站式完成。

套件说明 · 本 skill 属 aws-wechat-article-* 一条龙套件(共 9 个 slug,入口 aws-wechat-article-main)。跨 skill 的相对引用依赖同一 skills/ 目录,建议一并 clawhub install 全套。源码:https://github.com/aiworkskills/wechat-article-skills

能力披露(Capabilities)

本 skill 调 publish.py 直连微信公众号官方 API 发布图文。会把本篇 article.html 与 imgs/* 文件作为 POST body 上传到微信服务器。

  • 凭证读取:aws.env 的 WECHAT_{N}_APPID / WECHAT_{N}_APPSECRET(多槽位,N≥1)
  • 凭证外发:APPID / APPSECRET 以 query string 发给 api.weixin.qq.com/cgi-bin/token 换 access_token;后续请求带 access_token。微信返回的 token 只在进程内存短期缓存,不落盘
  • 内容外发:封面与正文插图以 multipart 发给 material/add_material;article.html 正文与标题/摘要以 JSON POST 发给 draft/add、freepublish/submit
  • 网络目标:默认 api.weixin.qq.com;可用 WECHAT_{N}_API_BASE / config.yaml.wechat_api_base 自配反代
  • 文件读:.aws-article/config.yaml、aws.env、本篇 article.yaml、article.html、imgs/*
  • 文件写:
    • publish.py 不写 article.yaml——media_id / publish_id / publish_completed 只打印,写回由智能体做(见下「publish_completed 门禁」)
    • 图片超过微信大小限制时会在源图旁生成压缩缓存 <原名>_compressed.jpg(需 Pillow)。这个文件不会被自动清理,也不会被当作正文图上传
    • article_init.py 写本篇 article.yaml 与可选 closing.md
  • shell:{python} {baseDir}/scripts/ 下的 publish.py、getdraft.py、article_init.py

建议:首次运行用 publish_method: draft 只入草稿箱确认效果,再切 published 真正群发。

路由

从选题到发出整条流程 → aws-wechat-article-main。本 skill 单独触发适用于已有 article.html 与封面、只差最后一步上传的场景。

配置检查 ⛔

任何操作前先按 首次引导 · 检测顺序 执行,通过后才继续(或用户明确书面确认「本次不检查」)。单独安装本 skill 时的口径见 branches.md「六」。

脚本与子命令

{baseDir} = 本 SKILL.md 所在目录,所有命令在仓库根执行。

脚本 / 子命令用途
article_init.py初始化或更新本篇 article.yaml(及可选 closing.md)。{python} {baseDir}/scripts/article_init.py <文章目录> [--title … --author … --digest …]
getdraft.py查已群发文章(published-list / published-fields / publish-get / article-get),用于补齐往期推荐链接。见 branches.md「五」
check-screening校验 config.yaml 的 publish_method
check-wechat-env按 config.yaml 槽位检查 aws.env 的 WECHAT_N_APPID / APPSECRET 是否已填
check环境检查:aws.env、各槽位、依赖、可选探测 token
accounts列出 config.yaml 中各槽位名称,并标记 aws.env 缺项
full一键全流程(上传封面 → 上传正文图 → 建草稿 → 视配置提交发布)
token / upload-thumb / upload-content-image / create-draft / publish / status分步操作,见 usage.md

publish_method(以 .aws-article/config.yaml 为准)⛔

值含义full 的行为
draft(默认)只进草稿箱创建草稿后不调 freepublish
published草稿 + 提交发布创建草稿后继续提交发布(异步)。full --publish 可在 draft 下单次强制带发布
none用户明确不填微信立即退出,不调任何微信接口(--publish 也被忽略)。其它子命令仍要凭证

多账号选槽位 ⛔

  1. 跑 {python} {baseDir}/scripts/publish.py accounts,把 config.yaml 的 wechat_accounts + wechat_{i}_name 列给用户(例如「您有 2 个账号:1. xiaoming,2. xiaoz」)。必须请用户选一个,不要替他挑。
  2. 选定后写 config.yaml 的 wechat_publish_slot: <整数>,或命令行 --account <序号或名称>(CLI 优先)。

槽位的数量与名称只来自 config.yaml;aws.env 里只有凭证。字段说明见 articlescreening-schema.md。

publish_completed 门禁 ⛔

字段在本篇 article.yaml。publish.py 不读、不改,由智能体维护:false = 发布流程未闭环,true = 已视为发布完成。

写回 true 之前,四项缺一不可:

  1. article.html 存在;
  2. 文章目录下存在封面 cover.(png|jpg|jpeg|webp)(不在 imgs/ 里);
  3. article.md 与 article.html 中均不含 placeholder;
  4. 发布命令成功并拿到回执(media_id 或 publish_id)。

任一不满足:只可标记为「已提交草稿,未闭环」,不得写回 publish_completed: true。

封面裁剪框(2.35:1 / 1:1)的细则见 branches.md「三」。

工作流

发布进度:
- [ ] 第0步:⛔ 配置检查;用户未给路径 → 先定目录并读 publish_completed 分流
- [ ] 第1步:读 config.yaml 的 publish_method(及是否 full --publish)
- [ ] 第2步:accounts 列账号 → ⛔ 请用户选槽位 → check-wechat-env 校验凭证
- [ ] 第3步:发布前检查(pre-publish-checklist + check-screening + check)
- [ ] 第4步:确认本篇目录产物齐全(article.html、cover.*、无 placeholder)
- [ ] 第5步:full(仅草稿或含发布,视第 1 步)
- [ ] 第6步:确认回执并向用户说明
- [ ] 第7步:⛔ 四项门禁全过 → 写回 publish_completed: true

第 0 步的分流表见 branches.md「一」;第 3 步清单见 references/pre-publish-checklist.md;第 5/6 步失败时的四类处理见 branches.md「二」。

命令示例(仓库根)

bash
{python} {baseDir}/scripts/publish.py check-screening
{python} {baseDir}/scripts/publish.py check-wechat-env
{python} {baseDir}/scripts/publish.py accounts
{python} {baseDir}/scripts/publish.py check
{python} {baseDir}/scripts/publish.py --account 1 full drafts/YYYYMMDD-标题slug/
{python} {baseDir}/scripts/getdraft.py published-fields

注意 --account 是全局选项,放在子命令之前。

分支与异常

未给路径的分流、发布失败四分类、封面裁剪框、几处回退、往期链接补齐、单独安装 → references/branches.md。

更多用法:usage.md、submit-guide.md、api-reference.md。

过程文件

读取产出
article.html、cover.*、imgs/、本篇 article.yaml、.aws-article/config.yaml、aws.env公众号草稿或已提交发布;成功后由智能体把 publish_completed: true 写回 article.yaml(publish.py 不改此键)

© aiworkskills, Apache-2.0. 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 9 other files (scripts, references) in skills/aws-wechat-article-publish of aiworkskills/wechat-article-skills.

  • SKILL.md
  • references/api-reference.md
  • references/branches.md
  • references/pre-publish-checklist.md
  • references/submit-guide.md
  • references/usage.md
  • scripts/article_init.py
  • scripts/getdraft.py
  • scripts/publish.py
  • skill.json

Open the folder on GitHubat commit ca036f7

Compare with similar skills

WeChat Official Account 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.

WeChat Official Account Publisher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WeChat Official Account Publisher this skillaiworkskills/wechat-article-skills672—~1.5kAutomated safety check: PassApache-2.0
WeChat Article Publisheriamzifei/wechat-article-publisher-skill157—~2.6kAutomated safety check: NotesMIT
Wechat Publishersakuraoxo-clio/wechat-publisher115—~1.4kAutomated safety check: NotesMIT
Media WritershareAI-lab/lab-skills315—~870Automated safety check: PassApache-2.0
Baoyu Post To Wechataiskillstore/marketplace433—~649Automated safety check: PassNone
Canghe Post To Wechatfreestylefly/canghe-skills4613 repos~3.4kAutomated safety check: NotesNone

Similar skills

  • WeChat Article Publisher

    iamzifei/wechat-article-publisher-skill

    Publishes Markdown or HTML articles as drafts to a WeChat Official Account through an API client, with a first-time user walkthrough.

    157 GitHub stars~2.6k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check: notes
  • Wechat Publisher

    sakuraoxo-clio/wechat-publisher

    把文章排版成微信公众号合规 HTML、自动上传图片、可选自动生成封面图,并通过官方 API 一键写入公众号草稿箱,用户只需在后台预览后发布。优先用组件化手写 HTML 做精排版,也支持 Markdown 快速排版。当用户提到「发布公众号」「推送到草稿箱」「公众号排版」「post to wechat」「微信公众号文章」时使用。

    115 GitHub stars~1.4k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes
  • Media Writer

    shareAI-lab/lab-skills

    Create platform-native content that resonates with each community's culture.

    315 GitHub stars~870 tokensUpdated 24 days ago
    Productivity & AutomationAuto-check passed
  • Baoyu Post To Wechat

    aiskillstore/marketplace

    Post content to WeChat Official Account (微信公众号). An agent skill from aiskillstore/marketplace.

    433 GitHub stars~649 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Canghe Post To Wechat

    freestylefly/canghe-skills

    Posts content to WeChat Official Account (微信公众号) via API or Chrome CDP.

    461 GitHub starsUsed in 3 repos~3.4k tokens
    Marketing & SEOAuto-check: notes
  • Wechat Writer

    flaqai/backlink_skills

    微信公众号文章的选题、研究、写作、改稿、审稿与交付工作流。Use when creating, outlining, researching, rewriting, auditing, or packaging Chinese WeChat Official Account articles, 微信文章, 公众号推文, 公众号长文, 热点解读, 干货教程, 观点文, 故事文, 对比测评…

    756 GitHub stars~1.8k tokensUpdated 17 days ago
    Productivity & AutomationAuto-check passed

More from aiworkskills/wechat-article-skills

All 9 skills in this repo
  • WeChat Article Assets Library

    aiworkskills/wechat-article-skills

    Manages a local business-material library and .aws preset packs for a WeChat official-account article workflow, including product images and theme presets.

    672 GitHub stars~1.5k tokensUpdated 18 days ago
    Auto-check passed
  • WeChat Article Formatter

    aiworkskills/wechat-article-skills

    Converts a Markdown WeChat article draft into themed, paste-ready HTML, with no network calls or credentials and a choice of built-in visual templates.

    672 GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed
  • WeChat Article Cover and Image Generator

    aiworkskills/wechat-article-skills

    Chinese-language skill that generates a WeChat article's cover image and in-body illustrations by calling an external image API, matching art style to the article's content.

    672 GitHub stars~1.8k tokensUpdated 18 days ago
    Auto-check passed
  • WeChat Official Account Pipeline

    aiworkskills/wechat-article-skills

    Orchestrates the full WeChat official account workflow from topic to draft, chaining sub-skills for writing, review, layout, images and publishing.

    672 GitHub stars~2k tokensUpdated 18 days ago
    Auto-check passed
  • WeChat Article Rewriting

    aiworkskills/wechat-article-skills

    Rewrites, continues, or polishes an existing WeChat article draft using a configurable language model, sending the full draft text to that endpoint.

    672 GitHub stars~2.2k tokensUpdated 18 days ago
    Auto-check passed
  • WeChat Article Compliance Reviewer

    aiworkskills/wechat-article-skills

    Local, offline pre-publish review for a WeChat official account article: sensitive words, typos and platform compliance, producing an actionable fix list.

    672 GitHub stars~1.5k tokensUpdated 18 days ago
    Auto-check passed

Works with

Questions about WeChat Official Account Publisher

What does WeChat Official Account Publisher do?

Publishes a finished article and its images directly to a WeChat official account through its official API, as a draft or a live broadcast. It uploads the article's HTML and image files straight to WeChat's servers, exchanging an app id and secret for an access token that is cached in memory only for the process's lifetime and never written to disk; cover and body images go up through the material-upload endpoint while the article body, title and summary go up as a JSON post to the draft or publish endpoint. Credentials come from named slots in a local environment file, and the API host can be repointed at a proxy through a config setting when needed.

When should I use WeChat Official Account Publisher?

WeChat Official Account Publisher fits situations like: publishing a finished WeChat article and its images via the API; pushing an article into the official account's draft box first; checking the WeChat API credentials and slots before publishing.

How do I install WeChat Official Account Publisher in Claude Code?

Run `npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-publish -a claude-code`. Or copy the skill folder (skills/aws-wechat-article-publish in aiworkskills/wechat-article-skills) into .claude/skills/aws-wechat-article-publish in your project. Claude Code loads it when a task matches its description.

How do I install WeChat Official Account Publisher in Codex?

Run `npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-publish -a codex`. Or copy the skill folder (skills/aws-wechat-article-publish in aiworkskills/wechat-article-skills) into .agents/skills/aws-wechat-article-publish in your project. Codex loads it when a task matches its description.

Can I use WeChat Official Account 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 aiworkskills/wechat-article-skills --skill aws-wechat-article-publish -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aws-wechat-article-publish, .gemini/skills/aws-wechat-article-publish, .github/skills/aws-wechat-article-publish and .opencode/skills/aws-wechat-article-publish in your project.

What does WeChat Official Account Publisher need to run?

Going by SKILL.md and its folder, WeChat Official Account Publisher needs Python for the scripts in its folder. Our summary lists: A WeChat official account with API access; App id and secret stored in a local environment file; Pillow, for compressing oversized images.

Does WeChat Official Account Publisher access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is WeChat Official Account 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 WeChat Official Account Publisher use?

WeChat Official Account Publisher is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does WeChat Official Account Publisher use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.1k tokens, read only when the agent opens those files.

What are the alternatives to WeChat Official Account Publisher?

Skills that share tags, products or a category with WeChat Official Account Publisher: WeChat Article Publisher (iamzifei/wechat-article-publisher-skill, 157 stars), Wechat Publisher (sakuraoxo-clio/wechat-publisher, 115 stars), Media Writer (shareAI-lab/lab-skills, 315 stars) and Baoyu Post To Wechat (aiskillstore/marketplace, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WeChat Official Account Publisher?

aiworkskills (a GitHub user) maintains it in aiworkskills/wechat-article-skills, which has 672 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 23, 2026.

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