Xiaowan WeChat Layout skill
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.
- 132 ★ on the repository
- Last commit
Extended access
Why this level
- The skill installs a second skill from another repository and runs preview audit scripts locally.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/xiaowan-wechat-layout-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill installs a second skill from another repository and runs preview audit scripts locally.
This is third-party code. Review the repository files before installing.
What it does
The skill lays out long reads for WeChat Official Accounts following the rules of its author, @小晚不在. The source can be Markdown, a document or a web page. By default the skill keeps the author's text and changes only the presentation; structure review and edits start on request. WeChat HTML comes from the base `gzh-design` skill, and this layer adds choices for fonts, spacing and emphasis, image placement, a horizontal cover, a short summary and a pre-publish check. The output is clean text, a preview with a copy button and a stable version for pasting into the editor. Two modes exist: with a styled first screen and without it.
Who it is for. Authors and editors of Chinese-language WeChat accounts who publish long texts and check how an article looks on a phone screen.
Good fit when
- A finished article must look the same in WeChat from issue to issue.
- Layout needs checking at 375 and 390 pixel widths before publishing.
- The article needs a cover and a short summary in the same style.
- Images disappeared or lines shifted after pasting into the WeChat editor and need diagnosing.
Not a fit when
- The article is published outside WeChat; the HTML targets its editor.
- You need a Russian translation of the text; the skill does not translate.
- The base `gzh-design` cannot be installed, and without it the HTML will not build.
Example request
Lay out this article in the author's style, keep the text unchanged, check it at 375 and 390 pixels and prepare a cover.Limitations
Skill instructions and texts are in Chinese. It targets Codex, invoked as `$xiaowan-wechat-layout-lite`. HTML generation needs `gzh-design` installed; the skill installs it itself when set up through the README prompt or `install.command`. The sample styling uses the author's materials, so for your own account the byline and IP elements must be replaced. The first screen is copied only after configuration; pasting into the WeChat editor is checked by hand.
How to disable. Delete the `xiaowan-wechat-layout-lite` skill folder from the Codex skills directory. The base `gzh-design` stays and is removed separately.
FAQ
What is gzh-design and is it required?
It is the base skill that produces WeChat-compatible HTML. Layout does not work without it, and the README setup adds it automatically.
Will the skill rewrite my text?
No, the text stays as is by default. Logic review and edits switch on when you ask for them.
How do the two modes differ?
The full mode keeps the first screen with its frame, masthead and editor block. The no-first-screen mode starts straight with the body text.
How do I install on a Mac?
Download and unpack the repository, then double-click `install.command`. It updates the skill and installs `gzh-design` if missing.
Which checks run before publishing?
A preview at 375 and 390 pixel widths and a check for lost images and broken lines after pasting into the editor.
Discussion
No questions or reviews yet.
Related
SkillsA WeChat article layout skill: turns Markdown into paste-ready HTML with inlined styles that survives pasting into the official account editor
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
Nine skills take a WeChat Official Account article from topic and text to layout and a draft in the backend
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Xiaowan WeChat Layout (this card) | no | 132 | |
| gzh-design-skill | no | 4,342 | the base WeChat HTML generator; this card adds diagnostics, cover, summary and paste checks on top |
| md2wechat | no | 3,798 | converts Markdown into the WeChat format; here the work follows the author's styling with a phone check |
README in short
The README sets out two styling modes, three workflows from diagnosis to publishing and two install paths. It has sample requests and the rules for checking at mobile width.
README badge
Original SKILL.md
--- name: xiaowan-wechat-layout-lite description: 按小晚的审美和编辑判断，为任意来源的长文制作舒适的手机阅读排版，支持有首屏/无首屏、已有配图整理、找图与生图、横方封面母图、简介与发布检查。适用于本地稿、Markdown、文档、网页或X长文的公众号排版、断行和密度优化、粘贴修复；内容来源不决定版式。默认保留原文，身份配色可配置，gzh-design只提供底层HTML能力。 --- # @小晚不在 · 公众号排版 以舒适的长文阅读体验为目标：理解文章的推进、轻重与停顿，把小晚的审美和编辑判断转成可执行的排版。素材可以来自本地稿、文档或网页，X 仅是一种获取渠道。`gzh-design` 提供底层 HTML 能力，不接管主题选择。提供完整同款与无首屏两个版本，两者共用小晚的排版系统。风格选择与内容编辑权限独立：选择同款不等于授权写稿或改变文章结构。 ## 固定组件与语义判断分开验收 开工读取 xiaowan-preset.md 的完整组件清单，结束逐项目视回查：无底色、图片细框、章节英文小标不能在换文章时丢失。reading-contract.md决定如何分段与强调；不是靠满足行数就算排版完成。 ## 已确认版式优先 先读 [references/reading-contract.md](references/reading-contract.md)。它覆盖下文及旧参考中与实际发布版冲突的首屏、强调和段落规则。 ## 使用前提与优先级 1. 生成 HTML 前读取已安装 `gzh-design/SKILL.md` 及适用组件；若未安装，按宿主安装流程使用原项目： `https://github.com/isjiamu/gzh-design-skill` 2. 优先级固定为：用户本次要求 ＞ 用户已经确认的本篇同款排版记录与历史发布稿 ＞ 本 Skill 的通用判断标准 ＞ `gzh-design` 主题默认值。 3. 本 Skill 不内置作者头像、IP、署名或私人素材。优先使用用户自己的内容资产。 4. 若用户说“正文已定稿”“不要改字”，内容逻辑诊断只提示风险，不改正文。 5. 若用户只反馈局部问题，只调整对应层，不重做已确认部分。 ## 只选择是否保留首屏 两个版本共用阅读层级与排版规则；个人信息、IP、栏目名称及整体配色可配置。先读 [personalization.md](references/personalization.md)，复用已有配置，再补齐必要信息： 1. **完整同款版**：保留首屏外框、刊头／日期、左标题右 IP、黑色编者按栏及提炼后的短摘要。 2. **无首屏版**：不生成上述首屏模块，直接进入文章正文；两版正文都完整保留原文第一段；无首屏版不插入首屏新增摘要。平台标题留给平台标题字段，不在正文重复制作题图卡。 用户已指定或本篇已有选择时直接沿用；首次缺少配置时一次性确认首屏及个人信息偏好；配色默认沿用预设，也可调整，不要求用户填写字号段距。