How to use the official skill provided for WeChat Mini Program development

Local Development

There are two tools available:

  1. WeChat Developer Tools’ built-in skill, requiring Electron Build 2.02.2607032 or later.
  2. CloudBase. This skill involves many components—especially those related to CloudBase development—with miniprogram-development specifically dedicated to mini-program development.

After proper configuration, simply set up the prompt to trigger automatic invocation:

For mini-program-related code writing, invoke the skills `miniprogram-development` and `wechatide`.  

Differences Between the Two Skills

miniprogram-development handles “how to develop a mini-program”, while wechatide-skill handles “how to actually operate the WeChat Developer Tools to verify and publish.”

Comparison Item miniprogram-development wechatide-skill
Positioning Development standards and technical roadmap for mini-programs Operational interface for WeChat Developer Tools
Core Questions Addressed What to write, how to structure code, which technologies to adopt How to launch, compile, debug, preview, and upload
Primary Capabilities Pages/components, routing, tabBar, project structure, CloudBase, SEO, publishing standards Login, project management, simulator, screenshotting, console/network inspection, automated clicks, preview/upload, cloud resource operations
Execution Method Guides Codex to modify project code and configurations Truly controls the Developer Tools via the wechatide CLI
Target Scope Primarily WeChat mini-programs Equally supports both mini-programs and mini-games
Alternatives When wechatide is unavailable, fallback to miniprogram-ci or CloudBase MCP Exclusively uses the current Developer Tools; does not handle generic code development
Security Rules Code modification protocols, pre-deployment checks, CloudBase scenario routing CLI authorization, version compatibility, login, token, asynchronous confirmation, and task polling
Update Relationship Generic development skill within the project Tightly coupled with WeChat Developer Tools versions; requires checking versionRelation

You can think of them as:

  • miniprogram-development: The engineer’s “Mini-Program Development Handbook”
  • wechatide-skill: The engineer’s “hands and eyes” for operating the WeChat Developer Tools

Typical usage scenarios:

  • “Add a new learning page.”
    Primarily relies on miniprogram-development, handling file structure, WXML/WXSS/JS, routing, and configuration.

  • “Compile the newly added page and take a screenshot to check.”
    Code writing still follows miniprogram-development; actual project opening, compilation, and screenshotting are delegated to wechatide-skill’s initializer → compiler → debugger.

  • “Upload a trial version.”
    Pre-upload verification follows miniprogram-development; uploading itself is executed by wechatide-skill’s previewer.

  • “Troubleshoot why network requests fail in the simulator.”
    miniprogram-development provides background context on mini-program runtime logic; wechatide-skill/debugger reads real-time console output, network logs, and runtime status.

  • “Implement mini-program SEO and enable indexing by WeChat Search.”
    Handled by miniprogram-development; this falls outside wechatide-skill’s scope.

  • “Operate the mini-game simulator.”
    Handled by wechatide-skill; miniprogram-development focuses primarily on mini-programs and does not fully cover mini-game development.

CloudBase Development

Not heavily used; details unclear.