md2wechat

Use md2wechat when the user wants to:

• - convert Markdown into WeChat Official Account HTML
• inspect resolved article metadata, readiness, and publish risks before conversion
• generate a local preview artifact or upload drafts
• inspect live capabilities, providers, themes, and prompts
• generate covers, infographics, or other article images
• create image posts
• write in creator styles or remove AI writing traces

Intent Routing

Choose the command family before doing any publish action:

• - Use convert / inspect / preview when the user wants a standard WeChat article draft (news), HTML conversion, article metadata, article preview, or a draft that needs --cover.
• Use create_image_post when the user says 小绿书, 图文笔记, 图片消息, newspic, 多图帖子, or asks to publish an image-first post rather than an article HTML draft.
• Do not route 小绿书 / 图文笔记 requests to convert --draft just because the user also has a Markdown article. A Markdown file can still be the image source for create_image_post -m article.md.
• Treat convert --draft and create_image_post as different publish targets, not interchangeable command variants.

Defaults And Config

• - Use this skill only when md2wechat is already available on PATH.
• Draft upload and publish-related actions require WECHAT_APPID and WECHAT_SECRET.
• Image generation may require additional image-service configuration in ~/.config/md2wechat/config.yaml.
• INLINECODE23 defaults to api mode unless the user explicitly asks for --mode ai.
• Check configuration in this order:

• - If the user asks to switch API domain, update api.md2wechat_base_url or MD2WECHAT_BASE_URL.
• Treat live CLI discovery output as the source of truth. Do not guess provider names, theme names, or prompt names from repository files alone.

Discovery First

Run these before selecting a provider, theme, or prompt:

• - INLINECODE33
• INLINECODE34
• INLINECODE35
• INLINECODE36
• INLINECODE37
• INLINECODE38
• INLINECODE39

Inspect a specific resource before using it:

• - INLINECODE40
• INLINECODE41
• INLINECODE42
• INLINECODE43
• INLINECODE44
• INLINECODE45
• INLINECODE46

When choosing image presets, prefer the prompt metadata returned by prompts show --json, especially primary_use_case, compatible_use_cases, recommended_aspect_ratios, and default_aspect_ratio.
When choosing an image model, prefer providers show <name> --json and read supported_models before hard-coding --model.

Core Commands

Configuration:

• - INLINECODE55
• INLINECODE56
• INLINECODE57

Conversion:

• - INLINECODE58
• INLINECODE59
• INLINECODE60
• INLINECODE61
• INLINECODE62
• INLINECODE63
• INLINECODE64

Image handling:

• - INLINECODE65
• INLINECODE66
• INLINECODE67
• INLINECODE68
• INLINECODE69
• INLINECODE70
• INLINECODE71
• INLINECODE72

Drafts and image posts:

• - INLINECODE73
• INLINECODE74
• INLINECODE75
• INLINECODE76
• INLINECODE77
• INLINECODE78
• INLINECODE79

Writing and humanizing:

• - INLINECODE80
• INLINECODE81
• INLINECODE82
• INLINECODE83
• INLINECODE84
• INLINECODE85
• INLINECODE86
• INLINECODE87
• INLINECODE88
• INLINECODE89

Article Metadata Rules

For convert, metadata resolution is:

• - Title: --title -> frontmatter.title -> first Markdown heading -> INLINECODE93
• Author: --author -> INLINECODE95
• Digest: --digest -> frontmatter.digest -> frontmatter.summary -> INLINECODE99

Limits enforced by the CLI:

• - --title: max 32 characters
• INLINECODE101: max 16 characters
• INLINECODE102: max 128 characters

Draft behavior:

• - If digest is still empty when creating a draft, the draft layer generates one from article HTML content with a 120-character fallback.
• Creating a draft requires either --cover or --cover-media-id.
• INLINECODE105 is a local image path contract for article drafts. --cover-media-id is for an existing WeChat permanent cover asset. Do not assume a WeChat URL or mmbiz.qpic.cn URL can be reused as thumb_media_id.
• INLINECODE109 is the source-of-truth command for resolved metadata, readiness, and checks.
• INLINECODE110 v1 writes a standalone local HTML preview file. It does not start a workbench, write back to Markdown, upload images, or create drafts.
• INLINECODE111 is still the convert-path preview flag; it is not the same thing as the standalone preview command.
• INLINECODE113 is degraded confirmation only; it must not be treated as final AI-generated layout.
• INLINECODE114 / --author / --digest affect draft metadata, not necessarily visible body HTML.
• Markdown images are only uploaded/replaced during --upload or --draft, not during plain convert --preview.

Agent Rules

• - Start with discovery commands before committing to a provider, theme, or prompt.
• Route by publish target first: article draft => convert; image post / 小绿书 / newspic => create_image_post.
• Prefer the confirm-first flow for article work: inspect -> preview -> convert / --draft.
• If the user says 小绿书, 图文笔记, 图片消息, newspic, or asks for a multi-image post, prefer create_image_post even when the source content lives in Markdown.
• Prefer generate_cover or generate_infographic over a raw generate_image "prompt" call when a bundled preset fits the task.
• Validate config before any draft, publish, or image-post action.
• If draft creation returns 45004, check digest/summary/description before assuming the body content is too long.
• If the user asks for AI conversion or style writing, be explicit that the CLI may return an AI request/prompt rather than final HTML or prose unless the workflow completes the external model step.
• Do not perform draft creation, publishing, or remote image generation unless the user asked for it.

Safety And Transparency

• - Reads local Markdown files and local images.
• May download remote images when asked.
• May call external image-generation services when configured.
• May upload HTML, images, drafts, and image posts to WeChat when the user explicitly requests those actions.