gzh-design-skill
A WeChat article layout skill: turns Markdown into paste-ready HTML with inlined styles that survives pasting into the official account editor
- 4,342 ★ on the repository
- Last commit
Extended access
Why this level
- Runs Python scripts to parse files and validate HTML
- Reads the project's source article files
Install
- Works in
Manual install
npx skills add https://github.com/isjiamu/gzh-design-skillOne-command skill install via skills.sh.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs Python scripts to parse files and validate HTML
- Reads the project's source article files
This is third-party code. Review the repository files before installing.
What it does
The skill assembles article layout for the Chinese WeChat platform, specifically for a gongzhonghao official account, from Markdown. Styling does not come from the model's imagination but from component libraries in references: six ready themes plus a shared library for code, images and signatures, and a theme can be generated from a description or a reference image. The skill adds section numbering, underlines keywords, builds an intro card and a table of contents, and supports code blocks, images and GIFs. The output is an HTML fragment with inlined styles and a preview page with a copy button. Two Python scripts check the source libraries and the final HTML for tags the platform strips and for correct wrapping of text nodes.
Who it is for. For authors and editors who lay out material for WeChat official accounts.
Good fit when
- You need to turn finished Markdown into WeChat article layout
- You need consistent styling from a theme rather than hand-tuning styles per article
- You need a custom theme from a description or a reference image
Not a fit when
- You need a regular web landing page, slides or a social card rather than WeChat layout
- The article is not written yet: the skill only lays out, it does not write
Example request
Lay out article.md for WeChat in the Moyu Green theme and give me a preview page with a copy buttonLimitations
The skill targets the WeChat editor's limits, so the output HTML is deliberately narrow: no style, script or div, no classes, no position, grid or external fonts, all styles inlined. It does not fit regular pages. Some steps, such as docx parsing or HTML validation, use Python scripts. The interface and themes are built around Chinese typography and full-width punctuation. The license is AGPL-3.0, which matters for commercial use and modification.
How to disable. Remove the gzh-design skill folder from the agent's skills directory, for example ~/.claude/skills/gzh-design.
FAQ
Does the skill write the article?
No. It only lays out. Bring the text yourself in Markdown, Word, PDF or plain form, and the skill first normalizes non-Markdown inputs.
What if none of the themes fit?
There is a theme generator: describe a style in one line or give a reference, and the skill builds a new component library and saves it for reuse.
Discussion
No questions or reviews yet.
Related
SkillsXiaowan WeChat Layout
xiaowan-wechat-layout-skill
A Codex skill that readies long articles for WeChat Official Accounts: phone-ready HTML, cover, summary and a pre-publish check.
A skill that lays out WeChat articles: Markdown goes into a local preview page and copies out as ready rich text.
wechat-skill: WeChat article layout and drafts
wechat-skill
A skill that lays out an article for a WeChat official account, writes from a topic and saves the result to drafts unpublished
A skill that turns a Markdown article into green-themed HTML for the WeChat publishing editor, uploading images.
Claude skill that typesets an article for WeChat with cards and SVG infographics, uploads images and saves a draft
Agent skill that builds social card carousels and paired covers from an article, screenshots, notes or video in two visual systems
README in short
The README presents a WeChat article layout skill for the Claude Code, Codex and Cursor agents. The core asset is the component libraries in references: six themes and a shared library, themes are picked from a single theme-index file, and SKILL.md handles only the workflow and decisions. The skill accepts Markdown, Word, PDF and plain text, normalizes them to Markdown, assembles HTML with inlined styles and span leaf wrapping, then checks the result with component_lint.py and validate_gzh_html.py. It installs with one skills.sh command or by cloning into the skills directory. AGPL-3.0 licensed.
README badge
Original SKILL.md
--- name: gzh-design description: 微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。 --- # 公众号文章排版 Skill 把一篇 Markdown 文章转换为可直接复制粘贴进微信公众号编辑器、且粘贴后样式不丢失的 HTML。 核心资产是 `references/` 下的主题组件库(每套一个主题:设计变量 + 各组件完整 HTML + 模板骨架 + 映射规则)外加 1 套通用增量库。