Loading
Convert Markdown to WeChat Official Account HTML, inspect supported providers/themes/prompts, generate article images, create drafts, write with creator styles, prepare title suggestions, and remove A
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add geekjourneyx/md2wechat-skill --skill md2wechat -a cursor -y
Convert Markdown to WeChat Official Account HTML, inspect supported providers/themes/prompts, generate article images, create drafts, write with creator styles, prepare title suggestions, and remove AI writing traces. Also use for unpublished Zhihu, CSDN, Toutiao, or Tencent Cloud Developer Community drafts through a browser. Use for product introductions, encyclopedia articles or entry drafts, and writing tailored to platforms or search targets.
Convert Markdown to WeChat Official Account HTML, inspect supported providers/themes/prompts, generate article images, create drafts, write with creator styles, prepare title suggestions, and remove AI writing traces. Also use for unpublished Zhihu, CSDN, Toutiao, or Tencent Cloud Developer Community drafts through a browser. Use for product introductions, encyclopedia articles or entry drafts, and writing tailored to platforms or search targets.
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.
Choose the command family before taking any publish or generation action:
inspect, preview, and convert.md2wechat skills read md2wechat references/sync/workflow.md --json for the current CLI's embedded workflow; the CLI prepares content and the Agent operates the browser.newspic, or multi-image post: use create_image_post, not convert --draft.generate_cover or generate_infographic over raw generate_image when a bundled preset fits.--plan --json) to get prompt intent, then hand it to the host image-generation tool if one is available outside md2wechat.title suggest <article.md> --json; it emits a host-Agent AI request and does not choose or write the final title.md2wechat skills read md2wechat references/writing/workflow.md --json and follow it as the host Agent. Prefer this route over advise or write for these requests; skip it for formatting-only tasks.md2wechat advise <article.md> --json; treat it as recommendation-only and keep inspect --json data.readiness.targets/blockers as the publish gate.write or humanize.Treat convert --draft and create_image_post as different publish targets, not interchangeable variants.
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
Subject-reference (image-to-image) capability before using --subject-reference:
md2wechat providers show minimax --json
Read supports_subject_reference on the provider and on each entry of supported_models. Only the minimax provider and its image-01 model accept --subject-reference, and the reference must be a publicly reachable http(s) portrait image URL; inline data URLs and local paths are rejected. Unsupported provider/model combinations fail immediately with CONFIG_INVALID, so do not retry them as generation failures.
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 --json
doctor readiness is local configuration attemptability. config wechat-accounts is local-only and never prints WeChat secrets. Use inspect --json for 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 core coding-agent SOP embedded in the current CLI binary. Use it when the local OpenClaw skill copy may be older than the executable on PATH; keep OpenClaw installation metadata from this platform skill as the platform-specific layer.
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> --json
Use CLI output as the source of truth for currently available modes, providers, themes, prompts, and layout modules.
md2wechat is already available on PATH.convert defaults to API mode unless the user explicitly asks for --mode ai.MD2WECHAT_API_KEY.create_image_post require WeChat credentials whenever the user explicitly requests those side effects.inspect, preview, and plain conversion are free of any global WeChat publishing credential requirement; API-mode preview and conversion still require a valid MD2WECHAT_API_KEY.MD2WECHAT_API_KEY; the CLI validates it before upload, draft, or create_image_post effects.--plan --json) only emits prompt intent for a host Agent or external tool and does not require image-provider credentials.title suggest --json only 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.doctor --json is local-only: it checks local readiness and does not perform live authentication, upload images, or create drafts.config show --format json when the user asks what configuration is currently effective.config wechat-accounts --json when the user asks which local WeChat accounts are configured.Prefer a confirm-first workflow for article work:
md2wechat inspect <article.md> --jsonmd2wechat preview <article.md>md2wechat convert <article.md> ...--upload, --draft, --cover, or --cover-media-id only 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.
When the user asks to format an article and has not chosen a theme or modules:
/tmp/md2wechat-format/<run-id>/article.formatted.md.md2wechat layout validate --file <formatted.md> --json.convert.Saving generated Markdown next to the source file requires explicit user confirmation and must not overwrite the source.
type and selectable from themes list --json.type: api and selectable: true themes.type: ai and selectable: true themes.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:
layout show <name> --json. Reuse the canonical witness.layout render for structured fields and --body-file (or --body-file - for stdin) for complex bodies, then validate the generated Markdown.layout list --lifecycle compatibility --json only for old-content migration. Local validation proves syntax acceptance only; production support is a release-conformance fact.gallery is recommended. For expand, pass header fields, a standalone ---, and Markdown body through --body-file. cover-reveal and expand default to complete static output; use first-layer only when the user explicitly requests an interaction candidate, and verify the target API before relying on it.Default module discipline:
Brand Profile lives at ~/.config/md2wechat/brand.md.
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 WeChat article draft creation through convert:
inspect --json and check data.readiness.targets.draft; when blocked, read matching data.readiness.blockers.--cover or --cover-media-id.mmbiz.qpic.cn URL can be reused as thumb_media_id.45004, check digest, summary, and description before assuming the body is too long.In the WeChat convert flow, Markdown images are uploaded or replaced only during --upload or --draft, not during plain conversion or preview.
doctor --json and config show --format json; report data.overall plus the blocking data.readiness.* item.layout validate, inspect the failing module with layout show, fix the generated artifact, then validate again.layout list --json.type and selectable, then choose a compatible theme or ask the user.