M
miniapp-official-scaffold-alignment
About miniapp-official-scaffold-alignment
miniapp-official-scaffold-alignment is a skill for checking whether a WeChat miniapp repository matches the official scaffold expectations before implementation changes. It identifies valid, missing, or risky structure and recommends the smallest next scaffold decision.
Key features
- 01Checks repository and miniapp roots
- 02Reviews project.config.json and app.json
- 03Validates page and component file sets
- 04Checks explicit TypeScript configuration
- 05Reports risks and next scaffold steps
Use cases
- 01Auditing a miniapp before page edits
- 02Checking page paths against app.json
- 03Reviewing custom component structure
- 04Planning the first scaffold correction
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ sun-sunshine06/ miniprogram-skills --skill miniapp-official-scaffold-alignmentAfter installing, type/miniapp-official-scaffold-alignmentin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
agents/openai.yamlreferences/example-prompts.mdofficial-scaffold-baseline.mdDetails
From the project READMEMiniapp Official Scaffold Alignment
Overview
Use this skill when scaffold correctness is the blocker. Validate the repository shape before changing pages, components, or build settings.
Quick Start
- Read
references/official-scaffold-baseline.md. - Identify the repository root and the miniapp code root.
- Check
project.config.json,app.json, page paths, component file sets, and TypeScript assumptions. - Report what is already valid, what is incomplete or risky, and the smallest next scaffold decision.
Core Rules
- Use only official WeChat documentation for normative claims.
- Prefer the smallest runnable scaffold that matches the project shape.
- Distinguish repository root from miniapp code root.
- If the repo authors in TypeScript, make the compiler-plugin path explicit.
- Require matching path-and-name file quartets for pages and components.
- Write "not yet specified" instead of inventing missing spec details.
Review Checklist
- Does
project.config.jsonpoint at the intended miniapp code root? - Does
app.json.pagesmatch real page folders? - Does every page have matching logic, structure, style, and config files?
- Do custom components declare
component: trueand have matching file sets? - Is TypeScript support explicit rather than implied?
- Does the repo layout leave room for sibling folders such as
docs/, backend code, or tooling?
Output Format
When answering, keep the result short and action-oriented:
- officially valid parts
- missing or risky parts
- recommended scaffold decision
- first edit to make
Resources
references/official-scaffold-baseline.md: official rule summary and practical implicationsreferences/example-prompts.md: reusable trigger examples and evaluation notes
Comments
Markdown supported