Skip to main content

Quick Start

This guide covers two ways to get started with the Mini Program AI Development Mode:

  • Scenario A: Create a new AI mini program from scratch — for brand new projects
  • Scenario B: Add AI skills to an existing mini program — for existing projects

Prerequisites​

Scenario A: Create a new AI mini program from scratch​

Step 1: Create the project​

# Create a project skeleton with AI development mode support
npx mp-skills new my-ai-app

# Enter the project directory
cd my-ai-app

This automatically generates the project structure with miniprogram/, cloudfunctions/, etc., and initializes a Git repository.

Step 2: Configure AppID​

Fill in your mini program AppID in the appid field of project.config.json.

Step 3: Search and install a Skill​

# View all available Skills
npx mp-skills find

Once you find a Skill you'd like, install it into the project (using order-skill as an example):

# Install a specific Skill
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

# Or install all Skills at once
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all

After installation, the tool automatically:

  • Copies the Skill to miniprogram/skills/<name>/
  • Updates miniprogram/app.json with agent.skills + subPackages
  • Updates project.config.json with packOptions.include
  • Writes skills-lock.json for version tracking

Step 4: Environment setup​

If the installed Skill depends on CloudBase services, run the one-click environment setup:

npx mp-skills setup

setup automatically aggregates cloud functions, creates database collections, and checks service configurations.

Step 5: Open in WeChat DevTools​

# Open the project with WeChat Developer Tools CLI
/Applications/wechatwebdevtools.app/Contents/MacOS/cli open --project /absolute/path/to/my-ai-app

Preview the project in DevTools and start experiencing the AI Agent conversation interface.

Scenario B: Add AI skills to an existing mini program​

If you already have a WeChat mini program project, follow these steps to integrate AI development mode.

Step 1: Enter your project directory​

cd your-existing-miniprogram

Make sure the project root contains project.config.json.

Step 2: Search and install a Skill​

# Browse available Skills
npx mp-skills find

# Install the Skill you need (using order-skill as an example)
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

Step 3: Validate the installation​

After installation, use the validate command to ensure everything is configured correctly:

npx mp-skills validate

validate checks:

  • Whether agent.skills in app.json is complete
  • Whether the Skill subpackage structure is compliant
  • Whether atomic API definitions are complete

Step 4: Environment setup​

# One-click environment setup
npx mp-skills setup

Step 5: Quality evaluation​

After installation, you can use the eval command for end-to-end quality evaluation:

# Configure LLM credentials (for automatic test case generation)
export WXA_SKILL_EVAL_LLM_BASE_URL=https://api.deepseek.com/v1
export WXA_SKILL_EVAL_LLM_API_KEY=sk-your-key
export WXA_SKILL_EVAL_LLM_MODEL=deepseek-chat

# Run evaluation (generate 3 test cases)
npx mp-skills eval -c 3

# Evaluate a specific Skill
npx mp-skills eval -s order-skill -c 3

# AI-assisted evaluation mode
npx mp-skills eval --mode agent -c 3

Quality evaluation validates the end-to-end availability of Skills, including the invocation chain in AI conversations.

Available Skills​

The following Skills can be installed via npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s <skill-name>:

SkillScenario
order-skillFood ordering — search restaurants, browse menus, place orders
bill-skillBill payment — view bills, pay online
hospital-skillHospital registration — search hospitals, select departments
queue-skillQueue management — take a number, check queue status
taxi-skillRide hailing — estimate fare, request a ride
shopping-skillTrendy shopping — browse products, view details
travel-skillTravel planning — search destinations, plan itineraries
party-skillParty planning — create events, get venue recommendations
payment-skillPayment — create payment orders, check status
todolist-skillTodo list — task management
text-gen-skillText generation — AI writing, translation, summarization
image-gen-skillImage generation — text-to-image
image-edit-skillImage editing — AI-powered image editing
water-trackerWater tracker — log water intake, view progress

Tip: Run npx mp-skills find or npx mp-skills list --remote to see the latest available Skills.

Next Steps​