Miniprogram Skills - Reusable Codex & Claude Code Skills for WeChat Mini Program Development

English | 中文

Reusable AI coding skills for WeChat Mini Program development, DevTools diagnosis, scaffold validation, and miniapp architecture optimization. Works with Codex and Claude Code.

Why This Exists

• WeChat Mini Program setup and DevTools failures repeat across projects
• CLI-visible failures and GUI-only failures need different workflows
• Wrong-root imports, stale compile settings, and TypeScript recognition drift are common
• These patterns are more reusable than any one product repo

Features

• 6 Reusable Skills - Covering scaffold validation, DevTools recovery, CLI diagnosis, GUI checks, architecture refactoring, and copy optimization
• Dual Platform Support - Works with both Codex and Claude Code
• TypeScript Ready - Full TypeScript support for miniapp development
• Bilingual Documentation - Complete English and Chinese documentation
• Machine-Readable Catalog - JSON-based skill catalog for automation
• Routing Evaluation - Replayable fixtures for skill boundary testing

Current Public Skills

Quick Start

For Codex Users

Skills are automatically loaded from the skills/ directory. Each skill has an agents/openai.yaml configuration file.

For Claude Code Users

Skills can be triggered in two ways:

1. Auto-trigger: Claude Code automatically invokes skills based on the description field
2. Manual trigger: Use slash commands like /miniapp-devtools-recovery

Installation

# Clone the repository
git clone https://github.com/Sun-sunshine06/miniprogram-skills.git

# Navigate to the project
cd miniprogram-skills

# Run validation
pwsh -File scripts/check.ps1

Use Cases

DevTools Diagnosis

When WeChat DevTools shows errors or behaves unexpectedly:

• Use miniapp-devtools-cli-repair for CLI-visible failures
• Use miniapp-devtools-gui-check for GUI-only runtime issues
• Use miniapp-devtools-recovery for wrong-root imports or template residue

Project Setup

When starting a new miniapp project:

• Use miniapp-official-scaffold-alignment to validate your scaffold
• Ensure proper TypeScript configuration
• Verify project structure matches official guidelines

Architecture Optimization

When your miniapp grows complex:

• Use miniapp-center-hub-refactor to reorganize navigation
• Use miniapp-user-facing-copy-trim to improve user-facing text

Repository Layout

.
├── docs/                           # Documentation
│   ├── conventions.md              # Writing conventions
│   ├── public-roadmap.md           # Development roadmap
│   └── skill-map.md               # Skill overview
├── evals/                          # Evaluation fixtures
│   ├── routing/                    # Routing test cases
│   └── routing-replays/           # Replay transcripts
├── manifests/                      # Machine-readable catalogs
│   └── skill-catalog.json         # Public skill catalog
├── schemas/                        # JSON schemas
├── skills/                         # Skill definitions
│   ├── miniapp-devtools-cli-repair/
│   ├── miniapp-devtools-gui-check/
│   ├── miniapp-devtools-recovery/
│   ├── miniapp-center-hub-refactor/
│   ├── miniapp-user-facing-copy-trim/
│   └── miniapp-official-scaffold-alignment/
└── tools/                          # Utilities
    └── wechat-gui-check/          # GUI smoke checker

Platform Compatibility

All skills support both Codex and Claude Code:

• Codex: Reads name and description from SKILL.md, uses agents/openai.yaml for platform config
• Claude Code: Reads all SKILL.md fields including optional tools and slash_command

Slash Commands

Each skill can be triggered manually in Claude Code using its slash command:

Local Validation

Run the shared local validation flow before opening a PR:

pwsh -File scripts/check.ps1

This command validates:

• Public skills structure and metadata
• Machine-readable skill catalog
• Routing fixtures and replay transcripts
• Negative-path fixtures
• Markdown links and bilingual cross-links
• Repository JSON validity
• Tool syntax
• External-project dry-run smoke checks

Contributing

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links

• Documentation
• Skill Map
• Public Roadmap
• Release Notes
• Changelog