Writing & Content wechat-publishingmarkdown-to-htmlclicontent-formattingseo-writingimage-generationdraft-automation

md2wechat Skill: Markdown-to-WeChat Formatting & Publishing

Turn Markdown into beautifully formatted WeChat articles: one-click styles, AI-generated covers, batch publishing, multi-account management.

FollowSkills review · FSRS-2.0
Not recommended
0/ 100 5-point scale 0.0 / 5
1 2 3 4 5 6
1Trust0 / 25 · 0.0/5

Evidence shows: SKILL.md explicitly requires explicit user requests for side effects like upload, draft, publishing, and uses inspect readiness checks as a publish gate; config wechat-accounts is declared local-only and never prints WeChat secrets; Brand Profile creation/editing requires explicit user consent. However, reliance on external API services (MD2WECHAT_API_KEY) and image providers, whose availability, data flow, and privacy policies are not disclosed in this static review; the license is Source Available (based on BUSL-1.1), not a standard open-source license, with strong commercial restrictions, and the publisher is unverified. No code was executed, so covert credential handling or data transmission cannot be ruled out; these uncertainties lower the trust score. Deductions: external service dependencies and unverified execution behavior.

2Reliability0 / 20 · 0.0/5

Evidence shows: SKILL.md provides detailed workflows, discovery commands, failure handling paths (e.g., doctor config show, layout validate), and expected outputs (e.g., PREVIEW_ACTION_REQUIRED). However, no test suites or CI coverage for the skill's key paths are visible; go.mod and CI workflows only show build and quality checks, not behavior tests. Thus, the happy path may be plausible, but edge cases, error handling, and failure feedback are thin. Static review cannot execute, so reliability cap is 10, hence the low score. Deductions: no test evidence, limited error-handling coverage.

3Adaptability0 / 15 · 0.0/5

Evidence shows: The skill targets WeChat article formatting and publishing for Chinese users, and the README provides Chinese documentation and examples, adapting to mainland-China context (though core may depend on overseas APIs). SKILL.md explicitly defines trigger conditions (e.g., detect markdown to WeChat formatting) and boundaries (e.g., no unrequested publishing). However, the skill relies on external APIs and image providers that may be unreachable from mainland China, and no offline alternatives are provided. Boundaries and triggers are clear, but environment-fit evidence is limited, hence the moderate-low score. Deductions: core functionality depends on overseas services, insufficient environment-fit evidence.

4Convention0 / 15 · 0.0/5

Evidence shows: SKILL.md is well-structured with sections (intent routing, discovery, config boundaries, etc.), the README provides installation guidance and docs links, and license and version info are clear (package.json version 3.2.0, CHANGELOG referenced). However, the license is Source Available, restricting commercial use, which may affect users; the publisher is unverified, and maintenance responsibility and update path are only claimed in README. Known limitations are mentioned in docs, but SKILL.md itself lacks version history or changelog. Deductions: non-standard license, incomplete maintenance responsibility info.

5Effectiveness0 / 15 · 0.0/5

Evidence shows: The skill claims to complete Markdown-to-WeChat HTML conversion, draft creation, image generation, etc., with detailed command flows. But no verified output examples or comparative advantage data are provided; the core value (e.g., 40+ styles) is unverified in static review. Whether output is directly usable is untested, and marginal value over manual or alternatives is unclear. Static review cannot execute, so effectiveness cap is 7, hence the low score. Deductions: no verified outputs, insufficient comparative-benefit evidence.

6Verifiability0 / 10 · 0.0/5

Evidence shows: The repo has CI workflows and go.mod, but quality gates do not include tests for the skill's key paths; the README demo GIF is visual evidence but not executed. No third-party test reports or independent validation. Static review cannot independently reproduce, so verifiability cap is 5, hence the low score. Deductions: no audited evidence, insufficient test coverage.

Evidence confidence:Low Reviewed Aug 07, 2026 Reviewed revision d656438f1e99
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
Before you use it
  • This skill depends on external API services and image providers whose availability, data flow, and privacy policies are not disclosed in this review. Before use, verify whether they are accessible from mainland China and understand their data privacy terms.
  • The license is Source Available (based on BUSL-1.1), restricting commercial use. If your use case involves commercial purposes, obtain authorization from the author first.
  • The publisher is unverified; treat maintenance commitments with caution. It is advisable to check the repository's activity and security track record yourself.
  • Static review found no test evidence; key-path reliability is unverified. Recommend a small-scale trial in a real environment to observe error feedback.
Review evidence [1][2][3][4][5][6][7]
See the full review method →

What does this skill do, and when should you use it?

md2wechat is a CLI skill for AI agents to create and publish WeChat Official Account articles. It provides a suite of verifiable commands to convert Markdown to WeChat HTML, check publication readiness, generate covers and infographics, create drafts, and manage multiple WeChat accounts. The skill emphasizes a discovery-first workflow, advising agents to rely on the CLI's JSON output as the source of truth rather than guessing. It distinguishes between a free AI mode and a professional API mode, the latter offering more themes and advanced layout modules.

This skill converts Markdown articles to WeChat article HTML (convert), supports local preview (preview) and optional draft creation (--draft) and image upload (--upload). It outputs structured metadata, readiness targets, and blockers via inspect --json, and recommends pre-publication checks. It supports cover and infographic generation using generate_cover and generate_infographic, and writing/AI-trace-removal via write and humanize commands. Additionally, title suggest generates title candidate prompts, and advise recommends enhancements for existing articles. The skill includes discovery commands (list/show) for themes, layout modules, providers, and prompts, enabling agents to query available options.

  1. A content creator who wants to quickly format a Markdown draft into a WeChat article and create a draft for later publishing.
  2. A team that needs to produce multiple WeChat articles with consistent, professional formatting, leveraging the professional API mode.
  3. A developer running an AI agent (e.g., Claude Code, Codex) who wants to automate WeChat publishing via CLI instead of manual uploads.
  4. An official account operator who needs to generate a cover or infographic for each article, using either direct image providers or the host agent's image generation capabilities.
  5. A writer who wants to make AI-generated articles sound more human by using the humanize command.
  6. A manager of multiple WeChat accounts who wants to view local account configurations and specify a target account during publishing.

What are this skill's strengths and limitations?

Pros
  • Comprehensive command set covering formatting, inspection, preview, and publishing
  • Machine-readable JSON output designed for AI agents, with a discovery-first approach
  • Professional API mode offers more themes and advanced layout modules with deterministic output, suitable for teams and matrix accounts
  • Includes doctor for local config health checks and config show to view effective configuration
  • Supports multi-account management and never prints WeChat secrets
  • Actively maintained with detailed documentation and an embedded SOP (skills read)
Limitations
  • Free AI mode only provides 3 basic themes and lacks advanced layout modules; output consistency depends on the external LLM
  • WeChat side-effects (draft, upload) require configured WeChat credentials, potentially requiring an API service application
  • API mode requires MD2WECHAT_API_KEY; commercial use requires a license due to the Source Available License (not fully open source)
  • Direct image generation requires image provider credentials; otherwise only plan mode is available
  • No built-in test suite, though doctor provides local checks
  • Some counts (68, 53) are mentioned without clear methodology, which may cause confusion

How do you install this skill?

Install globally via npm: npm install -g @geekjourneyx/md2wechat. Then run md2wechat config init to initialize. The skill requires Go 1.26.1+ (per repository metadata). Full installation guide is in docs/INSTALL.md.

How do you use this skill?

After installation, ensure md2wechat is on your PATH. For common tasks:
- Inspect article: md2wechat inspect article.md --json
- Preview locally: md2wechat preview article.md
- Convert and create draft: md2wechat convert article.md --draft --cover cover.jpg
- Generate cover: md2wechat generate_cover --article article.md
The skill provides detailed intent routing: for image-first posts, use create_image_post rather than convert --draft; for covers/infographics, prefer generate_cover/generate_infographic. Before any publish action, run inspect --json and check data.readiness.targets and blockers to confirm readiness.

How does this skill compare with similar options?

The repository does not explicitly name competitors. Compared to manual WeChat editors, its strength is automation via CLI and integration with AI agents. Other Markdown-to-HTML converters exist, but this skill is tailored for WeChat-specific needs like covers, drafts, and account management.

FAQ

Is this skill free to use?
Personal use, learning, evaluation, and non-profit use are free. Commercial use, SaaS, client delivery, white-labeling, redistribution, and training data purposes require a commercial license. See the repository license for details.
What credentials are required?
For API-mode conversion and preview, you need a valid MD2WECHAT_API_KEY. WeChat uploads, draft creation, and image-post creation require WeChat credentials. Direct image generation requires image provider credentials. Read-only discovery, inspect, preview, and plain conversion do not require WeChat publishing credentials, but API mode still requires the API key.
How do I ensure a draft can be created?
Before creating a draft, run md2wechat inspect article.md --json and check data.readiness.targets.draft for blockers. Draft creation requires a cover via --cover or --cover-media-id. If you get error 45004, check digest, summary, and description before assuming the body is too long.
Which AI agents are supported?
According to the README, it supports Claude Code, Codex, WorkBuddy, Kimi Work, Hermes Agent, OpenClaw, and any agent that can call local CLI commands. The skill provides stable machine-readable interfaces via JSON discovery output.

More skills from this repository

All from geekjourneyx/md2wechat-skill

Related skills