Md2wechat

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, and convert.
• Unpublished Zhihu, CSDN, or Toutiao draft: run 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.
• Image-first post, image note, image-text note, newspic, or multi-image post: use create_image_post, not convert --draft.
• Article cover or article infographic: prefer generate_cover or generate_infographic over raw generate_image when 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 keep inspect --json data.readiness.targets/blockers as the publish gate.
• Writing in a creator style or removing AI traces: use write or humanize.
• 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: ``bash md2wechat themes list --json md2wechat layout list --json ``

• A named theme, provider, prompt, or layout module: ``bash 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: ``bash md2wechat providers list --json md2wechat prompts list --kind image --json ``

• Subject-reference (image-to-image) capability before using --subject-reference: ``bash 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: ``bash md2wechat prompts list --kind title --json md2wechat prompts show wechat-title-expert --kind title --json ``

• Draft, upload, API local-readiness, or configuration troubleshooting: ``bash 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: ``bash 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.

Configuration Boundaries

• Assume md2wechat is already available on PATH.
• convert defaults 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_post require 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 valid MD2WECHAT_API_KEY.
• Named WeChat account execution requires a valid MD2WECHAT_API_KEY; the CLI validates it before upload, draft, or create_image_post effects.
• 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 --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.
• For stronger factual title hooks, pass --hook-level 2 or 3; do not treat generated titles as confirmed publishing intent.
• doctor --json is local-only: it checks local readiness and does not perform live authentication, upload images, or create drafts.
• Use config show --format json when the user asks what configuration is currently effective.
• Use config wechat-accounts --json when the user asks which local WeChat accounts are configured.

Article Workflow

Prefer a confirm-first workflow for article work:

1. md2wechat inspect <article.md> --json
2. md2wechat preview <article.md>
3. md2wechat convert <article.md> ...
4. Add --upload, --draft, --cover, or --cover-media-id only when the user explicitly asks for upload or draft creation.