CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

miniprogram-development

WeChat Mini Program development skill for building, debugging, previewing, testing, publishing, and optimizing mini program projects (小程序开发、调试、预览、发布). Covers project structure and config (`project.config.json`, `appid`, `miniprogramRoot`, `tabBar`, routing/navigation, icon assets), WeChat Developer Tools Nightly workflows (`wechatide` CLI, WeChat IDE Skills/MCP), `miniprogram-ci` preview/upload, console/network debugging, message push (消息推送) and customer-service auto-reply (客服消息), mini program SEO / search indexing (小程序搜索优化、页面收录、搜索推广、mpcrawler), and CloudBase integration (`wx.cloud`, 腾讯云开发, 云开发) when explicitly used. Use when users create, develop, modify, debug, preview, deploy, publish, or promote WeChat Mini Programs. NOT for Web frontend (use web-development), pure backend services (use cloudrun-development / cloud-functions), or UI-design-only tasks (use ui-design).

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is miniprogram-development in TencentCloudBase/CloudBase-AI-Toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured routing document with genuinely non-obvious domain rules, executable tabBar and skeleton examples, and excellent progressive disclosure across a real, verified reference bundle. Its main weaknesses are redundancy — the use-scope is stated twice and the wechatide-missing policy three times — and the fact that key executable commands and gate checks live in references, leaving some inline workflows as pointers.

Suggestions

Merge the 'When to use this skill' section (lines 64–78) into the Activation Contract's 'Use this first when' / 'Do NOT use for' lists, which already cover the same scope, and keep a single canonical statement of the wechatide-missing policy (currently repeated in the gotchas list, 'How to use this skill' step 5, and the 'Debugging, Preview, and Publishing' section).

Inline one or two representative `wechatide` and `miniprogram-ci` command invocations (e.g. the open-project and preview commands with `-c <clientName> --project <abs-path>`) so the most common operations are executable directly from SKILL.md without a reference hop.

Summarize the Change Safety Protocol and Deployment Gate checks in one or two bullet points each at the point they are mandated (lines 61–62), so the upload/publish workflow's validation checkpoints are visible in the body rather than only reachable via the referenced protocol files.

DimensionReasoningScore

Conciseness

Mostly dense, high-value domain guidance, but there is real redundancy: the 'When to use this skill' section (lines 64–78) restates the Activation Contract's 'Use this first when' / 'Do NOT use for' scope almost verbatim, and the wechatide-missing policy is stated three times (Activation Contract gotchas, 'How to use this skill' step 5, and 'Debugging, Preview, and Publishing'). This fits the score-3 anchor ('mostly efficient... could be tightened') rather than score 2, since none of it is generic explanation of concepts Claude already knows — nearly every line carries skill-specific rules.

3 / 5

Actionability

Concrete, executable material is present: a copy-paste `app.json` custom-tabBar config with a flex-centering recipe, a full minimal project skeleton (app.js/wxml/json + `project.config.json`), exact flags ('-c <clientName>', '--remote-npm-install'), and the precise API 'cloud.openapi.customerServiceMessage.send'. It falls short of the score-5 anchor because the highest-frequency executable actions — actual `wechatide` command invocations and `miniprogram-ci` calls — are deferred to reference files rather than shown inline, leaving the body's most common cases as routing instructions rather than copy-paste commands.

4 / 5

Workflow Clarity

The 'How to use this skill' section lays out a clear 5-step sequence with per-scenario routing, and the publish path has an explicit decision branch with a checkpoint (wechatide missing → report, offer install, wait for user; only after decline → fallback and enumerate lost capabilities), plus mandatory Change Safety Protocol and Deployment Gate gates before code changes and uploads. It sits at score 4 rather than 5 because the validation content of those gates lives entirely in referenced protocol files — the body never states what the gate checks are — so checkpoints are enforced by pointer rather than by explicit inline steps.

4 / 5

Progressive Disclosure

The body is a true overview: six reference files exist in the bundle, every one is linked with a clear 'read X when <scenario>' signal, and detail is split appropriately (SEO, message push, DevTools debugging, pitfalls, CloudBase integration each live in their own file). Reference files cross-link only to same-level peers as 'see also' navigation, not as buried content chains, so references are effectively one level deep — matching the score-5 anchor of a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a model example: it enumerates concrete capabilities across the full mini program lifecycle, provides bilingual natural-language triggers (Chinese and English), gives an explicit 'Use when' clause with concrete trigger verbs, and deftly disambiguates against sibling skills with named NOT-for routing. No dimension shows a gap against the top anchors.

DimensionReasoningScore

Specificity

The description enumerates many concrete capabilities — 'building, debugging, previewing, testing, publishing, and optimizing' — and grounds them in specifics like '`project.config.json`, `appid`, `miniprogramRoot`, `tabBar`', '`wechatide` CLI', '`miniprogram-ci` preview/upload', 'message push (消息推送)', 'mini program SEO / search indexing', and 'CloudBase integration (`wx.cloud`)'. This matches the score-5 anchor ('multiple specific concrete actions; comprehensive coverage') and exceeds the score-4 anchor, which expects only 'several specific actions with minor gaps' — here coverage spans the full lifecycle from project structure to publishing to promotion.

5 / 5

Completeness

It explicitly answers 'what' (the enumerated capability list) and 'when' via the literal clause 'Use when users create, develop, modify, debug, preview, deploy, publish, or promote WeChat Mini Programs', plus an explicit exclusion clause ('NOT for Web frontend... pure backend services... UI-design-only tasks'). This is a direct match for the score-5 anchor ('clearly and explicitly answers both what AND when with concrete trigger phrases'); the score-4 anchor requires a 'when' that 'could be more explicit', which is not the case here.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and bilingual: '小程序开发、调试、预览、发布', '消息推送', '客服消息', '云开发', '小程序搜索优化、页面收录、搜索推广', plus technical tokens users would echo verbatim ('project.config.json', 'appid', 'wechatide', 'wx.cloud', 'mpcrawler'). This matches the score-5 anchor (natural terms including synonyms and variations); the score-4 anchor ('a few natural terms missing') does not apply since both English and Chinese phrasings users would actually say are present.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous (WeChat Mini Programs) and the description pre-empts the nearest conflicts by naming the skills to use instead: 'use web-development', 'use cloudrun-development / cloud-functions', 'use ui-design'. This matches the score-5 anchor ('clear niche with distinct triggers; minimal conflict risk') and goes beyond the score-4 anchor's 'minor overlap risk with closely related skills' by explicitly routing those overlaps away.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

TencentCloudBase/CloudBase-AI-Toolkit

Path

config/.claude/skills/miniprogram-development/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.