Agent skill

WeChat Article Formatter

by aiworkskills in 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.

Apache-2.0Auto-check passedWriting & Content

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

Install WeChat Article Formatter

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

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

GitHub CLI
$ gh skill install aiworkskills/wechat-article-skills aws-wechat-article-formatting --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-formatting .claude/skills/aws-wechat-article-formatting && 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-formatting
GitHub stars
669
Token cost
~1.4k tokens
SKILL.md length
271 words
Files
92 (incl. scripts, references)
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

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.

  • Converting a Markdown WeChat draft into paste-ready formatted HTML
  • SKILL.md covers 能力披露(Capabilities), 路由, 配置检查 ⛔ and 内置模版, plus 6 more sections
  • Reaches aiworkskills.cn
  • Choosing a visual template and colour scheme for a WeChat article

What it does

Runs entirely locally through one Python script, reading only the article's own config and markdown files plus optional formatting presets, and writing nothing but the finished HTML file, with no shell access beyond that one script and no network or credential use at all. A formatting result is a built-in template, covering elements like the title decoration, lead paragraph, quote cards and image handling, multiplied by a colour scheme, each template naming which content types it suits and which it does not, such as a gentle template fitting tutorials but not severe topics.

Four templates ship built in, defaulting to the gentle one when no theme is named, while four additional templates are distributed separately through a companion presets skill rather than bundled here. The script can list every available theme and colour combination, or render a side-by-side preview page at phone width so a choice isn't made on name alone.

A strict rule governs image captions: only the text inside the explicit quoted title after the image path is shown to readers, never the descriptive text after the alt colon that is meant for an image-generation model, since reusing that text as the caption produces an obvious, redundant description of what the image already shows.

When your agent uses it

  • Converting a Markdown WeChat draft into paste-ready formatted HTML
  • Choosing a visual template and colour scheme for a WeChat article
  • Previewing several formatting themes side by side before picking one
  • Fixing an image caption that wrongly reuses the image-generation prompt text

Example prompts

  • “把这篇文章排版成资讯风格,墨绿配色。”
  • “List the available formatting themes and show me a preview of each.”
  • “把这篇排版换成书卷主题,预览一下 HTML 效果。”

Requirements

  • Python, to run the bundled format.py script

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 1 file in scripts/, which the agent can run.

    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:

    • aiworkskills.cn

    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 Article Formatter loads about 1.4k tokens when it runs, and up to ~28k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 271 words of instructions outside code blocks.

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

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). 271 words, ~1,416 tokens.

Download SKILL.mdSave it as .claude/skills/aws-wechat-article-formatting/SKILL.md (or your agent's skills folder). This skill also uses 91 other files; get the full folder from GitHub.
name
aws-wechat-article-formatting
description
公众号排版|Markdown 转 HTML|排版主题|段落样式 — 公众号一键排版工具,Markdown 文稿转微信后台可粘贴 HTML,多主题、多字号、段落样式切换,所见即所得。面向公众号编辑、独立作者、排版岗。触发词:「排版」「版式」「美化」「格式化」「字号」「段落样式」「换个排版主题」「换个版式」「转 HTML」「弄好看点」「调整格式」。换预设包/品牌包/整套主题配色请走 aws-wechat-article-assets;需要多环节串联(写+审+排+配图+发)请走 aws-wechat-article-main。
homepage
https://aiworkskills.cn
url
https://github.com/aiworkskills/wechat-article-skills

排版

公众号一键排版 —— Markdown 转微信后台可粘贴 HTML,多主题、多字号、所见即所得。

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

能力披露(Capabilities)

本 skill 为纯本地 Markdown → HTML 转换,零网络、零凭证。

  • 凭证:无
  • 网络:无
  • 文件读(仓库内):.aws-article/config.yaml、本篇 article.yaml、article.md、可选 closing.md、.aws-article/presets/formatting/<名>.yaml
  • 文件读(仓库外):~/.aws-article/presets/formatting/(跨项目共享的自定义主题;只读预设文件,不读凭证)
  • 文件写:本篇 article.html
  • shell:仅 {python} {baseDir}/scripts/format.py

单独安装可直接使用:format.py 零依赖、纯本地,无跨 skill 脚本调用。文档里指向 ../aws-wechat-article-main/references/*.md 的链接在套件未装齐时会断,但排版功能本身可用。

路由

一键发文且未明确只要排版 → aws-wechat-article-main。

配置检查 ⛔

任何操作前先按 首次引导 · 检测顺序 执行,通过后才继续(或用户明确书面确认「本次不检查」)。单独启用本 skill 时同样。

内置模版

排版 = 模版(骨架:标题装饰、导语、金句卡、图片处理、分隔、文末)× 配色(一组主色/次色,派生色自动重算)。名字即用途,选之前先看「适合」:

模版适合不适合配色(第一个是默认)
亲和教程、职场、面向新手的解释性长文严肃议题、极简冷硬的品牌黛紫 / 松绿 / 靛蓝
资讯快讯、评测、行业观察抒情散文、碎片化短段墨绿 / 绛红 / 藏青
书卷人文、读书、历史、深度长文工程文档、数据密集的评测朱砂 / 黛蓝 / 苍绿
杂志品牌故事、人物访谈、生活方式没有配图的稿子、信息型短文石青 / 驼褐 / 铁锈

不传 --theme 时的内置默认是 亲和。

另外四套不随 skill 内置,在 aiworkskills.cn 选好模版和配色后随 .aws 预设包下发到 .aws-article/presets/formatting/(见 assets skill):活力(产品发布、增长复盘)、手账(个人笔记、复盘)、硬朗(观点、宣言)、技术(工程实践、代码讲解)。网站上选的配色会烘进 YAML 顶层 variables,落地后不需要额外配置。

选之前先跑一次,判据、色值、每套配色的口径都在输出里,别只按名字猜:

bash
{python} {baseDir}/scripts/format.py --list-themes

说不清就看:--preview 把样张渲成并列对照页(每栏 375px,与真机同宽),用浏览器打开。

bash
{python} {baseDir}/scripts/format.py --preview 亲和 -o preview.html   # 该模版的每套配色并列
{python} {baseDir}/scripts/format.py --preview -o preview.html        # 所有模版的默认色并列

线上同一批预览:https://aiworkskills.cn/format-previews/<骨架>/<配色序号>.html,骨架名见 --list-themes。

换配色:--scheme <配色名>,或本篇 article.yaml 写 default_format_scheme: [松绿](单元素列表,由 main 的本篇预设落盘步骤写入)。

图注只认显式写的 title ⛔

![信息图:画面指令给生图模型看](imgs/x.png "图注给读者看")

括号里路径之后引号中的才是图注。alt 冒号后那段是画面指令,不会显示给读者。

早先的实现拿画面指令兼任图注,产出过这种东西:图上画着一个人站在 99.9 的牌子前望向远方,图注写「开发者站在巨型 99.9 分数牌前,视线越过分数望向复杂而开放的城市与工作现场」——把读者眼睛已经看见的复述一遍,零信息;图没生成出来时更会同一句话出现两次(破图 alt 一次、图注一次)。

没写 title 就不出图注,这是有意的:绝大多数图不需要图注,错的图注比没有更糟。图注该补充画面之外的东西——数据出处、一句判断、反常识的细节。

出不出图注还受合并配置的 caption_style 控制:有图注 全出、无图注 全不出、关键图有 只有信息位的图(信息图 / 实证)出。

从标准 markdown 认形态(主路径)

写作侧只产出标准 markdown,识别结构是排版层的事。让写手同时掌握标准 markdown 和一套私有语法就是耦合,而且那套语法只有本套件认得,稿子换个工具就废了。

渲染器会认这些形态,作者不用写任何特殊语法:

作者写的标准 markdown排版层做的事
**加粗**上本模版的重点色或荧光底——正文里唯一的扫读落点
- **标签**:说明标签在视觉上提出来(真稿里 62% 的列表项是这个形状)
- [ ] / - [x]换成该骨架的三态图标
> 金句。 —— 出处排成金句卡(正文位、带破折号出处的引用)
> 引文前面补一个大引号
![图](x.png "图注")四角标 + 图注
---装饰分隔
##标题装饰(笔锋 / 折角块)

只认形态,不推断语义。 有序列表在 markdown 里只表示「枚举」不表示「顺序」,所以不会因为看见 1. 2. 3. 就渲染成「第一步 第二步」——那是替作者断言一个他没说的顺序。真稿实测:三组多项有序列表里只有一组真有先后。

::: 组件语法排版侧仍然认,但写手不再产出——细则见 branches.md「一」。

工作流

排版进度:
- [ ] 第0步:⛔ 配置检查
- [ ] 第1步:确定模版与配色
- [ ] 第2步:转换
- [ ] 第3步:核对输出
第1步:确定模版与配色

--theme 显式指定最优先;不传则读本篇 article.yaml 的 default_format_preset(单元素列表),再无则内置默认 亲和。完整解析顺序与配色的同套规则见 branches.md「二」。

第2步:转换

在仓库根执行(路径按实际本篇目录调整):

bash
# 不传 --theme:读本篇 default_format_preset,否则 亲和
{python} {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md -o drafts/YYYYMMDD-slug/article.html

# 显式指定模版 / 配色(覆盖配置)
{python} {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md --theme 资讯 --scheme 绛红 -o drafts/YYYYMMDD-slug/article.html

# 自定义主色 / 字号
{python} {baseDir}/scripts/format.py article.md --color '#C0392B'
{python} {baseDir}/scripts/format.py article.md --font-size 15px

文末 {embed:…} 的合并规则见 branches.md「四」——占位符与配置对不上会直接失败。

第3步:核对输出
  • 正文不含文章标题(article.md 的首个 # 被跳过,标题在后台单独填)。
  • 配图标记还是 placeholder 时保留为 <img>,等 images skill 替换——终审前必须全部换成真实路径。
  • 其余输出特性(closing.md 追加、预格式化范围、表格对齐)见 branches.md「五」。

选项

选项说明默认值
--theme <名称>模版;省略则按本篇配置 → 内置 亲和亲和
--scheme <配色名>模版的配色(见 --list-themes);省略则读本篇 default_format_scheme,再无则模版默认色模版默认
--color <hex>自定义主色主题默认
--font-size <px>正文字号(同时覆盖主题 p / li 里的字号)16px
-o <路径>输出路径同名 .html
--list-themes列出模版:长相、适合/不适合、每套配色的色值与口径
--preview [模版名]渲成并列对照页(给模版名则并列它的每套配色,不给则并列所有模版)
--export-theme <名称>以 YAML 导出主题,可作为自定义主题起点
--no-preformat跳过 Markdown 预格式化

分支与细则

::: 组件与查找顺序、主题解析完整顺序、自定义主题、{embed:…} 合并规则、输出细节、设计新版式前的微信 HTML 限制 → references/branches.md。

过程文件

读取产出
article.md、.aws-article/config.yaml + 同目录 article.yaml(默认模版与 embeds)、closing.md(可选)article.html

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

  • SKILL.md
  • references/branches.md
  • references/components/bao/article-end.yaml
  • references/components/bao/checklist.yaml
  • references/components/bao/lead.yaml
  • references/components/bao/li-label.yaml
  • references/components/bao/quote-card.yaml
  • references/components/cai/article-end.yaml
  • references/components/cai/checklist.yaml
  • references/components/cai/h2-deco.yaml
  • references/components/cai/img-deco.yaml
  • references/components/cai/lead.yaml
  • references/components/cai/li-label.yaml
  • references/components/cai/quote-card.yaml
  • references/components/checklist.yaml
  • references/components/closing.yaml
  • references/components/compare.yaml
  • … and 75 more

Open the folder on GitHubat commit ca036f7

Compare with similar skills

WeChat Article Formatter 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 Article Formatter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WeChat Article Formatter this skillaiworkskills/wechat-article-skills669—~1.4kAutomated safety check: PassApache-2.0
Wechat Article To Markdownjackwener/wechat-article-to-markdown1.1k—~352Automated safety check: PassNone
Hailaobao Gzh Designwwwzhouhui/skills_collection283—~1.1kAutomated safety check: PassNone
Clean Content FetchLeoYeAI/openclaw-master-skills2.2k—~574Automated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Wechat Article To Markdown

    jackwener/wechat-article-to-markdown

    Fetch WeChat Official Account (微信公众号) articles from mp.weixin.qq.com and convert to Markdown.

    1.1k GitHub stars~352 tokensUpdated 6 mo ago
    Documents & OfficeAuto-check passed
  • Hailaobao Gzh Design

    wwwzhouhui/skills_collection

    把 Markdown 文章排版成微信公众号可直接粘贴的 HTML,内置 7 套排版风格。触发词:公众号排版、微信排版、gzh 排版、typeset for wechat、Markdown 转公众号。不触发:只想改文字不改格式、要生成小红书图文。

    283 GitHub stars~1.1k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed
  • Clean Content Fetch

    LeoYeAI/openclaw-master-skills

    获取干净、可读的网页正文内容,适合现代网页、博客、新闻、公告和微信公众号文章抓取;支持网页正文提取、内容清洗、去噪、Markdown 输出,适用于普通 fetch 效果不佳、页面噪音较多或动态渲染干扰的场景。Clean content fetch for modern web pages, article extraction, WeChat article capture, content…

    2.2k GitHub stars~574 tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Md2wechat

    geekjourneyx/md2wechat-skill

    Convert Markdown to WeChat Official Account HTML. An agent skill from geekjourneyx/md2wechat-skill.

    3.7k GitHub stars~3.8k tokensUpdated 15 days ago
    Media & CreativeAuto-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.

    669 GitHub stars~1.5k tokensUpdated 17 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.

    669 GitHub stars~1.8k tokensUpdated 17 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.

    669 GitHub stars~2k tokensUpdated 17 days ago
    Auto-check passed
  • WeChat Official Account Publisher

    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.

    669 GitHub stars~1.5k tokensUpdated 17 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.

    669 GitHub stars~2.2k tokensUpdated 17 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.

    669 GitHub stars~1.5k tokensUpdated 17 days ago
    Auto-check passed

Works with

Questions about WeChat Article Formatter

What does WeChat Article Formatter do?

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. Runs entirely locally through one Python script, reading only the article's own config and markdown files plus optional formatting presets, and writing nothing but the finished HTML file, with no shell access beyond that one script and no network or credential use at all. A formatting result is a built-in template, covering elements like the title decoration, lead paragraph, quote cards and image handling, multiplied by a colour scheme, each template naming which content types it suits and which it does not, such as a gentle template fitting tutorials but not severe topics.

When should I use WeChat Article Formatter?

WeChat Article Formatter fits situations like: converting a Markdown WeChat draft into paste-ready formatted HTML; choosing a visual template and colour scheme for a WeChat article; previewing several formatting themes side by side before picking one; fixing an image caption that wrongly reuses the image-generation prompt text.

How do I install WeChat Article Formatter in Claude Code?

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

How do I install WeChat Article Formatter in Codex?

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

Can I use WeChat Article Formatter 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-formatting -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-formatting, .gemini/skills/aws-wechat-article-formatting, .github/skills/aws-wechat-article-formatting and .opencode/skills/aws-wechat-article-formatting in your project.

What does WeChat Article Formatter need to run?

SKILL.md names no scripts, command-line tools or credentials: WeChat Article Formatter is instructions for the agent only. Our summary lists: Python, to run the bundled format.py script.

Does WeChat Article Formatter access the network?

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

Is WeChat Article Formatter 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 Article Formatter use?

WeChat Article Formatter 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 Article Formatter use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 27k tokens, read only when the agent opens those files.

What are the alternatives to WeChat Article Formatter?

Skills that share tags, products or a category with WeChat Article Formatter: Wechat Article To Markdown (jackwener/wechat-article-to-markdown, 1.1k stars), Hailaobao Gzh Design (wwwzhouhui/skills_collection, 283 stars), Clean Content Fetch (LeoYeAI/openclaw-master-skills, 2.2k stars) and Social (coreyhaines31/marketingskills, 54k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WeChat Article Formatter?

aiworkskills (a GitHub user) maintains it in aiworkskills/wechat-article-skills, which has 669 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.