What is gzh-design-skill?

gzh-design-skill is a skill for AI coding agents such as Claude Code, Codex, and Cursor that turns a Markdown article into polished HTML ready to paste directly into the WeChat official account (gongzhonghao) publishing editor. Instead of writing raw Markdown and manually reformatting it inside WeChat's editor, a writer hands the agent a Markdown file, picks one of six built in visual themes, and the agent assembles HTML that keeps its formatting intact after pasting, because WeChat's editor strips many common web styling techniques. The six themes cover different article styles, from a card heavy tutorial and review look to a minimalist graphite style, a spacious contemplative style, and a magazine style meant for internal newsletters and case studies. If none of the built in themes fit, the tool includes a theme generator that can create a brand new theme from a short text description or a reference image, and save it locally for reuse. Content handling includes code blocks in light and dark variants, images, animated GIFs, block quotes, and lists, along with automatic numbering of sections, underlined keyword highlighting pulled from the body text, and generated summary cards and tables of contents. Because WeChat's editor blocks tags like style, script, and div along with CSS classes, grid layout, and fixed positioning, the generated HTML avoids all of these and instead inlines every style directly and wraps text in plain span tags. Quality is checked with two Python validation scripts rather than relying on the AI model to get formatting right on its own. One script lints the underlying theme component library for problems, and the other checks the final generated HTML file for banned tags, missing inline styling, and punctuation issues, refusing to pass until there are zero errors. The finished output includes a preview page with a one click copy button so the formatted article can be pasted straight into the WeChat editor. This project is intended specifically for formatting long form articles for the WeChat official account platform. It is explicitly not meant for building regular web pages, slide decks, social media image cards, or for writing article content itself, a Markdown draft needs to already exist before this tool is used on it. It is licensed under AGPL-3.0.