isjiamu/gzh-design-skill

What it solves

It solves the difficulty of creating visually appealing, professional layouts for WeChat Official Account articles using Markdown. It specifically addresses the problem of "style loss" where formatting often breaks when pasting HTML into the WeChat editor by ensuring all styles are strictly inlined and compliant with the platform's restrictive filtering rules.

How it works

The project acts as a "Skill" for AI Agents (such as Claude Code, Cursor, or Codex). The agent takes a Markdown file and a chosen theme, then parses the content to assemble an HTML document using a predefined library of components. To ensure quality, it uses a dual-validation system: component_lint.py checks the source component library for anti-patterns, and validate_gzh_html.py verifies the final HTML output for banned tags and formatting errors before delivery.

Who it’s for

Content creators, bloggers, and analysts who write in Markdown and want to convert their long-form articles, tutorials, or reports into polished WeChat Official Account posts without manual formatting.

Highlights

• 6 Pre-built Themes: Includes diverse styles like "Moyu Green" for tutorials and "Graphite Minimalist" for tech reviews.
• Theme Generator: Allows users to create entirely new custom themes using a simple text description or a reference image.
• Platform Compliance: Automatically handles WeChat-specific constraints, such as wrapping text in <span leaf=""> and banning <style> or <div> tags.
• Smart Formatting: Automatically adds chapter numbering, keyword underlining, and generates introduction cards and tables of contents.
• Agent-Agnostic: Works across various LLMs (Claude, GPT, Gemini, DeepSeek, etc.) because the layout logic is embedded in the component libraries and scripts rather than the model's intuition.