| name | wechat-formatter |
| description | Render article markdown into WeChat-style HTML as an independent executor. Use when Codex needs公众号排版预览, WeChat HTML output, or a publishable HTML artifact generated from an article markdown draft. |
WeChat Formatter
Convert article markdown into WeChat-style HTML for preview, inspection, and downstream publishing. If a sibling *-writing-pack.json exists, this executor will also consume summary points, highlight quotes, share copy, and ending CTA blocks.
Quick Start
Run the default command:
.venv/bin/python -m skill_runtime.cli run-skill wechat-formatter --input content-production/drafts/ai-content-system-article.md
Prepare Source Article
Start from an article markdown draft that is already written and ready for visual formatting.
If a sibling *-writing-pack.json exists, it will be used as an optional sidecar.
Follow Formatting Workflow
- Read the article markdown draft.
- Render the content through the shared formatter runtime in
skills/wechat-formatter/runtime.py.
- Produce standalone WeChat preview HTML for inspection and downstream publishing.
- When a writing-pack sidecar exists, append summary / quotes / share-copy / CTA presentation blocks without altering the source article file.
- If
wechat-studio is involved, let the workbench apply its own theme, typography, inline image placement, and draft-push workflow on top of this executor.
Write Output
Write the primary exported file to:
content-production/ready/<slug>-wechat.html
Respect Constraints
- This skill formats and renders content; it does not author the article itself
- HTML quality depends on the article draft and current workbench state
- Workbench theme choices belong to
wechat-studio; this skill itself should stay focused on producing HTML from Markdown
Read Related Files
- Shared runtime:
skills/wechat-formatter/runtime.py
- Pipeline entry:
skill_runtime/engine.py
- Workbench integration:
skills/wechat-studio/frontend/server.py
- Execution guide:
docs/wechat-formatter-execution-spec.md
