md2wechat
Skill0 starsChanged 35 days agoMITView on GitHub
Convert Markdown to WeChat Official Account HTML. Use this whenever the user wants WeChat article formatting, article preview, WeChat draft upload, image generation for articles, cover or infographic generation, image-post creation, writer-style drafting, title suggestions, AI trace removal, or current discovery of supported providers, themes, prompts, and layout modules.
- Reads credentials
5 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- lingengyuan/my-skillstheir own version, first seen Nov 14, 2026
- mailzwj/skillstheir own version, first seen Nov 1, 2026
- geekjourneyx/md2wechat-skilledited, first seen Jul 23, 2026
- zkkython/md2wechat_skillstheir own version, first seen Apr 16, 2026
- bozhouDev/bozhou-skillstheir own version, first seen Mar 22, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- geekjourneyx/md2wechat-skill★ 3.8k88% same
Wrote their own version · 4
- bozhouDev/bozhou-skills★ 78same name
- lingengyuan/my-skills★ 9same name
- zkkython/md2wechat_skills★ 4same name
- mailzwj/skills★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository38 other files it gives its agents.
- aranya-nonstandardSkill
- bailian-zxSkill
- brand-research-scoutSkill
- city-new-mall-scanSkill
- commercial-hubSkill
- commercial-report-deliverySkill
- commercial-site-researchSkill
- laoyang-article-excelSkill
- laoyang-article-imagesSkill
- laoyang-channels-video-agentSkill
- laoyang-quality-checkSkill
- laoyang-short-videoSkill
- laoyang-topic-researchSkill
- mall-competition-scanSkill
- platform-content-adapterSkill
- restaurant-evaluatorSkill
- shui-on-xintiandiSkill
- store-site-analysisSkill
- tianmuli-teamSkill
- urf-curetailSkill
- wanhua-luxelakesSkill
- warm-article-dailySkill
- wechat-account-analyzerSkill
- wechat-article-extractorSkill
- wechat-brand-extractSkill
- wechat-managerSkill
- wechat-mp-data-collectSkill
- wechat-mp-publishSkill
- wechatreaderSkill
- zouyi-chaserSkill
- zsxq-bd-harvestSkill
- 余峰-perspectiveSkill
- 潘玉明-perspectiveSkill
- 王智明-perspectiveSkill
- 王玮-perspectiveSkill
- 管有冬-perspectiveSkill
- 老杨拆商业-perspectiveSkill
- 蔡云-perspectiveSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
39 rules. 0 are common, 23 are distinctive, and 16 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
23
Distinctive
This author's own choices. Worth a look.
16
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Use this skill to operate the md2wechat CLI.
- Very specific: line 23
Treat convert --draft and create_image_post as different publish targets, not interchangeable variants.
- Distinctive: line 27
Use CLI discovery as the source of truth, but keep it scoped to the next decision.
- Very specific: line 29
Use capabilities for aggregate routing facts, resource list for lightweight selection fields, show for one full resource definition, and …
- Distinctive: line 31
Run the smallest useful discovery set:
- Distinctive: line 88
Use CLI output as the source of truth for currently available modes, providers, themes, prompts, and layout modules.
- Very specific: line 96
Read-only discovery, inspect, preview, and plain conversion are free of any global WeChat publishing credential requirement.
- Very specific: line 102
Use config show --format json when the user asks what configuration is currently effective.
- Very specific: line 103
Use config wechat-accounts --json when the user asks which local WeChat accounts are configured.
- Distinctive: line 107
Prefer a confirm-first workflow for article work:
- Very specific: line 112
Add --upload, --draft, --cover, or --cover-media-id only when the user explicitly asks for upload or draft creation.
- Very specific: line 115
When the intended execution path is convert --mode ai --custom-prompt ..., run inspect with the same --mode ai --custom-prompt ...
- Distinctive: line 119
When the user asks to format an article and has not chosen a theme or modules:
- Distinctive: line 121
Read the article and optional Brand Profile.
- Distinctive: line 122
Use discovery output as facts.
- Distinctive: line 124
Keep the source Markdown read-only.
- Very specific: line 125
Create a temporary formatted Markdown artifact, for example /tmp/md2wechat-format/<run-id>/article.formatted.md.
- Very specific: line 134
Read type and selectable from themes list --json.
- Distinctive: line 137
Do not use collection descriptors such as non-selectable theme groups as concrete themes.
- Distinctive: line 138
If Brand Profile names a theme, verify it through CLI discovery before using it.
- Distinctive: line 139
If a requested theme is invalid or mode-incompatible, stop that path and choose a valid theme or ask the user.
- Distinctive: line 145
Use this decision frame:
- Very specific: line 152
Use CLI discovery as the source of truth for layout syntax instead of memorizing or guessing body_format values:
- Very specific: line 155
Use layout render for structured fields and --body-file (or --body-file - for stdin) for complex bodies, then validate the generated …
- Very specific: line 156
Default discovery returns recommended modules.
- Distinctive: line 160
Do not pile on modules.
- Distinctive: line 161
Use at most one hero, one verdict, and one cta unless the user explicitly asks for more.
- Distinctive: line 168
Do not silently switch from API mode to AI mode after an API failure.
- Distinctive: line 169
Use AI mode only when the user asks for it or accepts losing advanced layout rendering.
- Distinctive: line 170
If an AI-mode conversion completes, it is acceptable to briefly mention that API mode supports advanced layout modules and stronger visual …
- Distinctive: line 178
Read it as context for voice, theme preferences, module preferences, CTA preferences, and forbidden expressions.
- Distinctive: line 179
Treat quantity preferences as soft constraints.
- Distinctive: line 180
Verify any named theme or module through CLI discovery.
- Distinctive: line 181
If Brand Profile does not exist, do not block the task.
- Distinctive: line 182
Create or edit Brand Profile only when the user explicitly asks.
- Distinctive: line 186
Do not create drafts, upload images, publish, or call remote image generation unless the user asks for that action.
- Very specific: line 192
Use inspect --json and check data.readiness.targets.draft.
- Very specific: line 194
Do not assume a WeChat URL or mmbiz.qpic.cn URL can be reused as thumb_media_id.
- Very specific: line 195
If draft creation returns 45004, check digest, summary, and description before assuming the body is too long.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
md2wechat
Use this skill to operate the md2wechat CLI. Keep the skill focused on execution decisions. For full command tutorials, installation details, and FAQ-level explanations, refer users to the project docs instead of expanding this runtime protocol.
Intent Routing
Choose the command family before taking any publish or generation action:
- Standard article HTML, article preview, metadata inspection, or WeChat article draft: use
inspect,preview, andconvert. - Image-first post, image note, image-text note,
newspic, or multi-image post: usecreate_image_post, notconvert --draft. - Article cover or article infographic: prefer
generate_coverorgenerate_infographicover rawgenerate_imagewhen a bundled preset fits. - Host-agent image generation request with no provider configured: use image plan mode (
--plan --json) to get prompt intent, then hand it to the host image-generation tool if one is available outside md2wechat. - WeChat title candidates for an existing article: use
title suggest <article.md> --json; it emits a host-Agent AI request and does not choose or write the final title. - Existing article or draft, user asks what to improve next: run
md2wechat advise <article.md> --json; treat it as recommendation-only and keepinspect --json data.readiness.targets/blockersas the publish gate. - Writing in a creator style or removing AI traces: use
writeorhumanize. - Provider, theme, prompt, or layout uncertainty: run discovery first. Do not guess from memory or repository files.
Treat convert --draft and create_image_post as different publish targets, not interchangeable variants.
Discovery First
Use CLI discovery as the source of truth, but keep it scoped to the next decision. Do not run the full catalog for tasks that do not need provider, theme, prompt, or layout selection.
Use capabilities for aggregate routing facts, resource list for lightweight selection fields, show for one full resource definition, and render for materialized prompt/layout output. JSON stdout is compact; use jq only when a human needs formatted output.
Run the smallest useful discovery set:
- Article formatting with no theme or modules chosen:
md2wechat themes list --json md2wechat layout list --json - A named theme, provider, prompt, or layout module:
md2wechat themes show <name> --json md2wechat providers show <name> --json md2wechat prompts show <name> --kind <kind> --json md2wechat layout show <name> --json - Image generation or image-preset selection:
md2wechat providers list --json md2wechat prompts list --kind image --json - Title suggestion prompt selection:
md2wechat prompts list --kind title --json md2wechat prompts show wechat-title-expert --kind title --json - Draft, upload, API local-readiness, or configuration troubleshooting:
md2wechat doctor --json md2wechat config show --format json md2wechat config wechat-accounts --jsondoctorreadiness is local configuration attemptability.config wechat-accountsis local-only and never prints WeChat secrets. Useinspect --jsonfor article-specific target readiness. - Unknown CLI version, changed behavior, or capability uncertainty:
md2wechat version --json md2wechat capabilities --json md2wechat skills list --json md2wechat skills read md2wechat --json
md2wechat skills read md2wechat --json reads the SOP embedded in the current CLI binary. Prefer it when the installed external skill, README, or repository checkout may be stale relative to the executable on PATH.
For simple local actions such as preview, humanize, or a user-specified command with explicit flags, do not run unrelated provider, theme, prompt, or layout discovery.
Inspect specific resources only when the task needs them:
md2wechat providers show <name> --json
md2wechat themes show <name> --json
md2wechat prompts show <name> --kind <kind> --json
md2wechat layout show <name> --jsonUse CLI output as the source of truth for currently available modes, providers, themes, prompts, and layout modules.
Configuration Boundaries
- Assume
md2wechatis already available onPATH. convertdefaults to API mode unless the user explicitly asks for--mode ai.- API-mode preview and conversion require a valid
MD2WECHAT_API_KEY. - WeChat upload, article draft creation, and
create_image_postrequire WeChat credentials whenever the user explicitly requests those side effects. - Read-only discovery,
inspect,preview, and plain conversion are free of any global WeChat publishing credential requirement; API-mode preview and conversion still require a validMD2WECHAT_API_KEY. - Named WeChat account execution requires a valid
MD2WECHAT_API_KEY; the CLI validates it before upload, draft, orcreate_image_posteffects. - Direct image generation requires image-provider credentials; image plan mode (
--plan --json) only emits prompt intent for a host Agent or external tool and does not require image-provider credentials. title suggest --jsononly emits a title-generation prompt request for the host Agent or external model. It does not call a model, upload, create drafts, or write back to Markdown.- For stronger factual title hooks, pass --hook-level 2 or 3; do not treat generated titles as confirmed publishing intent.
doctor --jsonis local-only: it checks local readiness and does not perform live authentication, upload images, or create drafts.- Use
config show --format jsonwhen the user asks what configuration is currently effective. - Use
config wechat-accounts --jsonwhen the user asks which local WeChat accounts are configured.
Article Workflow
Prefer a confirm-first workflow for article work:
md2wechat inspect <article.md> --jsonmd2wechat preview <article.md>md2wechat convert <article.md> ...- Add
--upload,--draft,--cover, or--cover-media-idonly when the user explicitly asks for upload or draft creation.
inspect is the source-of-truth command for structured metadata, checks, readiness targets, and blockers. In --json output, read data.readiness.targets and data.readiness.blockers before deciding whether convert, upload, or draft is blocked. If the requested target is blocked, stop and report the matching blockers; do not continue by guessing from legacy booleans or checks alone. Do not invent data.agent_readiness, data.target_readiness, ArticleState, state files, or a second readiness/state object. preview writes only byte-identical final API HTML from a successful converter result; with --json, inspect diagnostics are returned in data.inspect and are never wrapped into that file. It does not upload images, create drafts, or write back to Markdown. convert performs conversion and only the explicitly requested upload/draft effects. convert --preview is the convert-path preview flag and is not the same as the standalone preview command. On PREVIEW_ACTION_REQUIRED or PREVIEW_FAILED, this invocation does not create or overwrite preview HTML. With --json, PREVIEW_ACTION_REQUIRED returns an empty data.output_file. Any pre-existing explicit output path is stale and must not be treated as this invocation's result; use the returned prompt for host-Agent work or report the failure.
When the intended execution path is convert --mode ai --custom-prompt ..., run inspect with the same --mode ai --custom-prompt ... before trusting readiness.
Formatting Protocol
When the user asks to format an article and has not chosen a theme or modules:
- Read the article and optional Brand Profile.
- Use discovery output as facts.
- Choose a compatible theme and a small set of modules from the article's content goal.
- Keep the source Markdown read-only.
- Create a temporary formatted Markdown artifact, for example
/tmp/md2wechat-format/<run-id>/article.formatted.md. - Insert only layout modules whose required fields can be filled correctly.
- Run
md2wechat layout validate --file <formatted.md> --json. - Pass the formatted Markdown artifact to
convert.
Saving generated Markdown next to the source file requires explicit user confirmation and must not overwrite the source.
Theme Selection
- Read
typeandselectablefromthemes list --json. - API mode can use only
type: apiandselectable: truethemes. - AI mode can use only
type: aiandselectable: truethemes. - Do not use collection descriptors such as non-selectable theme groups as concrete themes.
- If Brand Profile names a theme, verify it through CLI discovery before using it.
- If a requested theme is invalid or mode-incompatible, stop that path and choose a valid theme or ask the user.
Layout Modules
Advanced layout modules render only in API mode. AI mode (--mode ai) does not parse :::module syntax, so advanced layout cards will not render there.
Use this decision frame:
attention: help readers decide whether the article is worth reading.readability: make mobile reading easier.memorability: make one judgment, quote, metric, or brand anchor stick.conversion: help readers save, follow, inquire, share, or buy.
Use CLI discovery as the source of truth for layout syntax instead of memorizing or guessing body_format values:
- Inspect the opener, body schema, canonical executable example, and structurally distinct variants with
layout show <name> --json. Reuse the canonical witness. - Use
layout renderfor structured fields and--body-file(or--body-file -for stdin) for complex bodies, then validate the generated Markdown. - Default discovery returns recommended modules. Use
layout list --lifecycle compatibility --jsononly for old-content migration. Local validation proves syntax acceptance only; production support is a release-conformance fact.
Default module discipline:
- Do not pile on modules.
- Use at most one hero, one verdict, and one cta unless the user explicitly asks for more.
- Skip modules when the article does not provide enough content to fill them honestly.
API And AI Mode
- API mode is the default and is required for advanced layout modules.
- AI mode is a lighter path and does not render advanced layout modules.
- Do not silently switch from API mode to AI mode after an API failure. That changes the output capability.
- Use AI mode only when the user asks for it or accepts losing advanced layout rendering.
- If an AI-mode conversion completes, it is acceptable to briefly mention that API mode supports advanced layout modules and stronger visual structure.
Brand Profile
Brand Profile lives at ~/.config/md2wechat/brand.md.
- It is free-form Markdown, not YAML and not a fixed schema.
- The CLI does not parse it.
- Read it as context for voice, theme preferences, module preferences, CTA preferences, and forbidden expressions.
- Treat quantity preferences as soft constraints.
- Verify any named theme or module through CLI discovery.
- If Brand Profile does not exist, do not block the task. You may mention once that system defaults will be used.
- Create or edit Brand Profile only when the user explicitly asks.
Publishing Side Effects
Do not create drafts, upload images, publish, or call remote image generation unless the user asks for that action.
Before every explicit WeChat side effect—image upload, article draft creation, or create_image_post—require configured WeChat credentials and use the target-matched readiness/preflight path. Discovery and inspection remain non-publishing paths; preview and plain conversion are free of any global WeChat publishing credential requirement, while API mode still requires a valid MD2WECHAT_API_KEY.
Before draft creation:
- Use
inspect --jsonand checkdata.readiness.targets.draft; when blocked, read matchingdata.readiness.blockers. - Draft creation requires a cover via
--coveror--cover-media-id. - Do not assume a WeChat URL or
mmbiz.qpic.cnURL can be reused asthumb_media_id. - If draft creation returns
45004, check digest, summary, and description before assuming the body is too long.
Markdown images are uploaded or replaced only during --upload or --draft, not during plain conversion or preview.
Failure Handling
- Missing or invalid config: run
doctor --jsonandconfig show --format json; reportdata.overallplus the blockingdata.readiness.*item. - Invalid layout syntax: run
layout validate, inspect the failing module withlayout show, fix the generated artifact, then validate again. - Unknown layout modules warn for forward compatibility; verify typos against
layout list --json. - Theme rejection: check
typeandselectable, then choose a compatible theme or ask the user. - AI request or style-writing flows may return a prompt/request rather than final prose or HTML unless the external model step is completed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

