wechat-miniprogram-skill — Claude Code skill for native WeChat Mini
Turns your coding agent into a native WeChat Mini Program developer: performance, code size and platform compatibility rules baked in.
npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a claude-codeWhat wechat-miniprogram-skill does
This skill sets the agent up as a senior developer working on native WeChat Mini Programs in JavaScript. The stated priorities are performance, code size and native compatibility. TypeScript and cross-platform frameworks are ruled out, so if your project runs on Taro or Uni-app the guidance will pull against your stack.
The rules cover the everyday mechanics. Logic uses ES6+ with arrow functions for this binding, and async APIs get wrapped in Promises or async/await. State changes go through this.setData(), with data paths recommended for partial updates such as this.setData({ 'list[0].text': 'new' }). In WXML every wx:for needs wx:key, and taps are bound with bind:tap or catch:tap. Layouts use rpx with BEM naming, and reusable logic should live in Component() rather than Page().
A separate section lists the traps. Dates break in iOS when the string contains hyphens, so they get replaced with slashes before new Date(). Tab navigation requires wx.switchTab, and the page stack caps at 10 — worth checking if your flows chain a lot of screens. Overlaying <canvas>, <video> or <map> only works with <cover-view>.
What it helps with
- write Mini Program logic in plain JavaScript without frameworks
- update state partially with data paths instead of a full setData
- fix new Date() failing on iOS because of hyphens
- stay under the page stack limit during navigation
- overlay UI elements on top of canvas and video
Example prompts for the agent
- help me build a product list page in WXML with wx:key
- rewrite this setData to update a single field via a data path
- why does this date string fail to parse on iOS
How to install wechat-miniprogram-skill
1Skills CLI (Vercel)
npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a claude-code2Manually: put the files in place
~/.claude/skills/wechat-miniprogram-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wechat-miniprogram-skill/
1Skills CLI (Vercel)
npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a codex2Manually: put the files in place
.agents/skills/wechat-miniprogram-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a cursor2Manually: put the files in place
.cursor/skills/wechat-miniprogram-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Gourdbaby/wechat-miniprogram-skill wechat-miniprogram-skill2Manually: put the files in place
.github/skills/wechat-miniprogram-skill/SKILL.md1Skills CLI (Vercel)
npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/Gourdbaby/wechat-miniprogram-skillManually: put the files in place
.devin/skills/wechat-miniprogram-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about wechat-miniprogram-skill
How do I install wechat-miniprogram-skill in Claude?
Run npx skills add Gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill -a claude-code. The skill file then lands at ~/.claude/skills/wechat-miniprogram-skill/SKILL.md.
What does wechat-miniprogram-skill do?
It gives the agent guidelines for native WeChat Mini Program work: setData usage, WXML and WXSS conventions, native component handling, plus common bugs like iOS date parsing.
Does it work for a Taro or Uni-app project?
No. Cross-platform frameworks and TypeScript are explicitly excluded, the skill targets native JavaScript only.