AI

Enables integration of advanced AI models into WeChat Mini Programs via wx.cloud.

Install

mkdir -p .claude/skills/ai-model-wechat && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7961" && unzip -o skill.zip -d .claude/skills/ai-model-wechat && rm skill.zip

Installs to .claude/skills/ai-model-wechat

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use this skill for WeChat Mini Program AI via wx.cloud.extend.AI (小程序, 企业微信小程序, wx.cloud apps). Features generateText and streamText with callbacks (onText, onEvent, onFinish). Models via wx.cloud.extend.AI.createModel with groups hunyuan-exp (小程序成长计划), cloudbase (main managed), or custom-*. Model IDs (deepseek-v4-flash, deepseek-v3.2, hunyuan-2.0-instruct-20251111, glm-5, kimi-k2.6) go in the data wrapper model field. API differs from JS/Node SDK — streamText needs data wrapper, generateText returns raw response. MUST run two-step preflight before code — see body. Keywords: Mini Program AI, wx.cloud.extend.AI, 小程序成长计划, ai_miniprogram_inspire_plan, Token Credits 资源包, generateText, streamText, createModel, hunyuan-exp, TokenHub, Hunyuan, DeepSeek, GLM, Kimi, MiniMax. NOT for browser/Web (use ai-model-web), Node.js backend (use ai-model-nodejs), or image generation (use ai-model-nodejs).
898 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • →Generates text via WeChat cloud functions
  • →Streams model output with callbacks
  • →Handles WeChat model authentication
  • →Creates model instances via API

How it works

Interfaces with wx.cloud.extend.AI via specialized JavaScript wrappers tailored for the WeChat Mini Program runtime environment.

Inputs & outputs

You give it
Model ID and prompt text
You get back
Streaming or static text response

When to use ai-model-wechat

  • →Developing WeChat Mini Program AI features
  • →Integrating text generation into WeChat apps
  • →Streaming AI responses in mini programs

About this skill

Sibling skills (local only)

Sibling CloudBase skills ship beside this skill. Use local relative paths such as ../auth-tool-cloudbase/SKILL.md.

If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do not HTTP-fetch remote skill or protocol markdown into the agent context.

When to use this skill

Use this skill for calling AI models in WeChat Mini Program using wx.cloud.extend.AI.

Use it when you need to:

  • Integrate AI text generation in a Mini Program
  • Stream AI responses with callback support
  • Read text and fields from an image (OCR, receipts, forms) with a vision-capable model
  • Call Hunyuan models from the WeChat environment

Do NOT use for:

  • Browser/Web apps → use ai-model-web skill
  • Node.js backend or cloud functions → use ai-model-nodejs skill
  • Image generation → use ai-model-nodejs skill (not available in Mini Program)
  • Runtimes without a CloudBase SDK (native apps, Python, etc.) → use http-api-cloudbase skill (it now includes the ai_model OpenAPI spec for direct HTTP calls)

⛔ STOP — wx.cloud.extend.AI.createModel(provider) argument is not a vendor / model name

Read this before writing any createModel(...) line. Agents frequently hallucinate this argument. There are exactly four legal shapes. Anything else is a bug.

✅ Legal createModel(provider) argumentWhen to use it
"cloudbase"Default, including 小程序成长计划. Main managed group (TokenHub-backed, multi-vendor pool). Growth Plan quota covers hy4-preview / hy3 / deepseek-v4.1-flash; only deepseek-v4.1-flash accepts images. Vendor + concrete model go into the model field, e.g. { model: "deepseek-v4.1-flash" }.
"hunyuan-v3"Legacy plan group, being retired. Only hy3 is available and no new models are added. Existing plan-enrolled code keeps working; new code uses cloudbase + a plan model.
"hunyuan-exp"Older legacy builtin group — only if DescribeAIModels still returns it. Its default hunyuan-2.0-instruct-20251111 went offline on 2026-05-31; never target that id.
"custom-<your-name>"A user-defined GroupName you onboarded via CreateAIModel. Must start with custom- (e.g. custom-kimi, custom-openai-compat).

❌ Do NOT write any of these — they are all wrong

wx.cloud.extend.AI.createModel("deepseek")                   // wrong — vendor, not GroupName
wx.cloud.extend.AI.createModel("deepseek-v4.1-flash")        // wrong — model id goes in `model`
wx.cloud.extend.AI.createModel("hunyuan")                    // wrong — vendor family
wx.cloud.extend.AI.createModel("hunyuan-2.0-instruct-20251111")  // wrong — model name
wx.cloud.extend.AI.createModel("glm") / "kimi" / "minimax"   // wrong — vendor names
wx.cloud.extend.AI.createModel("custom")                     // wrong — placeholder
wx.cloud.extend.AI.createModel(modelName)                    // wrong — do not reuse the model-id variable

✅ Correct pattern — provider vs model are two different fields

// Growth Plan branch (enable the model in the console first)
const model = wx.cloud.extend.AI.createModel("cloudbase"); // ← provider / GroupName
await model.streamText({
  data: { model: "deepseek-v4.1-flash", messages: [...] }  // ← concrete model id
});

// Token Credits branch — same provider, any managed model you enabled
await model.streamText({
  data: { model: "glm-5.3", messages: [...] }
});

Decision procedure (when the user names a specific model)

  1. The user says "use DeepSeek v3.2" / "use hunyuan thinking" / "use Kimi k2.6" / …
  2. First run the eligibility decision tree below — the provider is "cloudbase" in almost every case, including Growth Plan environments (cloudbase + a plan model). "hunyuan-v3" only appears in existing code that already used it; "hunyuan-exp" only if DescribeAIModels still returns that older group.
  3. Put the model id into the model field: { model: "deepseek-v4.1-flash" }, { model: "hy3" }, { model: "kimi-k2.6" }, … (inside data when you call streamText).
  4. Before using the model id, make sure it is present in DescribeAIModels({ GroupName: "cloudbase" }).Models[]. If not, enable it via UpdateAIModel.

If you are about to type wx.cloud.extend.AI.createModel( and the thing inside the parentheses is a vendor name or a model id — stop. It is almost certainly one of the four legal values above.

Mandatory Two-Step Preflight

You MUST NOT jump straight into wx.cloud.extend.AI.createModel(...). Before writing any business code, confirm billing eligibility and group readiness in this fixed order: ① eligibility → ② group readiness. Do not swap the two.

Preflight ① · Billing Eligibility (two parallel billing paths)

The Mini Program side has two billing paths: 小程序成长计划 (checked first) and Token Credits 资源包 (generic fallback). Both settle through the cloudbase main managed group — on the plan, the model is one of hy4-preview / hy3 / deepseek-v4.1-flash, and the plan quota is drawn first; hunyuan-v3 is the legacy plan group that only draws plan quota and is being retired.

  1. Fetch envId via the MCP tool queryEnv action=info.

  2. Pick the branch by user intent:

User intentEligibility to check firstcreateModel provider on hitModel selectionGuidance on miss
No model specified / default callCheck 小程序成长计划 enrollment first; if not enrolled, fall back to Token Credits resource pack"cloudbase" in both casesEnrolled: deepseek-v4.1-flash (covers text and images; hy4-preview / hy3 are text-only alternatives — enable it in the "cloudbase" group first). Otherwise: pick a text model with the user, then verify/enable it in the "cloudbase" group via DescribeAIModels → DescribeManagedAIModelList → UpdateAIModelPlan not enrolled → point to https://docs.cloudbase.net/ai/ai-inspire-plan; resource pack missing → purchase link
User requests a hunyuan-* model小程序成长计划 enrollment"cloudbase" (+ a plan model for the plan quota)Verify the exact Model in DescribeAIModels({ GroupName: "cloudbase" }).Models[] and enable it via UpdateAIModel if missingEnrolled but the model is missing → enable it; not enrolled → point to the plan page, or use "cloudbase" + the resource pack
User requests deepseek-* / glm-* / kimi-* / minimax-* / other non-hunyuan managed modelsToken Credits 资源包 activation"cloudbase"Do NOT assume the model is already enabled. DescribeAIModels → if missing, DescribeManagedAIModelList for the canonical Model string → UpdateAIModel with Status: 1 (full-replacement Models[])Resource pack not activated → purchase link
User requests a third-party / self-hosted (non-managed) modelSkip billing eligibility and go to "Custom onboarding"Custom GroupName (must start with custom-)Registered via CreateAIModel.Models[]Offer both console + CreateAIModel paths
  1. Check 小程序成长计划 enrollment:
callCloudApi({
  service: "tcb",
  action: "DescribeActivityInfo",
  params: {
    ActivityNames: ["ai_miniprogram_inspire_plan"], // PascalCase preferred; switch to camelCase if InvalidParameter is returned
  },
})

Hit criterion: the response's attendRecords contains at least one entry where activityName === "ai_miniprogram_inspire_plan" and envId matches the current environment. On hit, use createModel("cloudbase") + one of hy4-preview / hy3 / deepseek-v4.1-flash (enable it in the group first); the call draws the plan's free quota. Pick deepseek-v4.1-flash unless the user needs a text-only model. Legacy code on createModel("hunyuan-v3") + hy3 still works but that group is being retired — migrate it to cloudbase.

⚠️ The gifted Token is source-scoped. It applies to Mini Program client calls and administrator-identity calls (console playground, calls made inside a cloud function) only. A call from any other origin does not draw on it and settles against the environment's resource-point pool instead — which is what a user sees as "the Token pack did not apply, resource points were charged". When a report sounds like that, check the call origin before touching the code or the model config. Same rule for the Token Credits pack path below.

On miss: do NOT silently fall back. Tell the user "the current environment is not enrolled in 小程序成长计划", surface the enrollment entry https://docs.cloudbase.net/ai/ai-inspire-plan, and ask whether to enroll and retry, or to switch to the Token Credits resource pack path with a non-hunyuan model.

  1. Check the Token Credits resource pack (when the path leads to the "cloudbase" main managed group):
callCloudApi({
  service: "tcb",
  action: "DescribeEnvPostpayPackage",
  params: {
    EnvId: "<current envId>",
  },
})

Hit criterion: envPostpayPackageInfoList contains an entry whose postpayPackageId starts with pkg_tcb_tokencredits_, has status ∉ [3, 4] (not expired, not disabled), and versionSwitchStatus is not in a blocking state.

On miss: surface the purchase link (replace {region} with the environment's Region from queryEnv, e.g. ap-shanghai, and {envId} with the real ID — never leave the placeholders):

https://buy.cloud.tencent.com/CloudBase?buyType=resPack&region={region}&envId={envId}

Preflight ② · Group Readiness (mandatory for every Mini Program AI call)

Passing eligibility does not mean the target model is callable. No model is enabled by default in the "cloudbase" main managed group — you must first call DescribeAIModels to see what is enabled, then (if missing) DescribeManagedAIModelList for the aut


Content truncated.

When not to use it

  • →Developing standard Node.js backends
  • →Creating browser-based web applications
  • →Non-WeChat environment tasks

Prerequisites

Wx.cloud environmentWeChat Mini Program project

Limitations

  • →Strictly for WeChat Mini Programs
  • →No support for image generation

How it compares

It strictly uses the unique WeChat cloud API schema rather than common OpenAI or LangChain libraries.

Compared to similar skills

ai-model-wechat side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
ai-model-wechat (this skill)05moNo flagsIntermediate
telegram-dev211moReviewIntermediate
shopify-apps17moReviewIntermediate
ccxt-typescript19moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

More by TencentCloudBase

View all by TencentCloudBase →

miniprogram-development

TencentCloudBase

WeChat Mini Program development rules. Use this skill when developing WeChat mini programs, integrating CloudBase capabilities, and deploying mini program projects.

3792

spec-workflow

TencentCloudBase

Standard software engineering workflow for requirement analysis, technical design, and task planning. Use this skill when developing new features, complex architecture designs, multi-module integrations, or projects involving database/UI design.

1091

ai-model-nodejs

TencentCloudBase

Use this skill when developing Node.js backend services or CloudBase cloud functions (Express/Koa/NestJS, serverless, backend APIs) that need AI capabilities. Features text generation (generateText), streaming (streamText), AND image generation (generateImage) via @cloudbase/node-sdk ≥3.16.0. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended), DeepSeek (deepseek-v3.2 recommended), and hunyuan-image for images. This is the ONLY SDK that supports image generation. NOT for browser/Web apps (use ai-model-web) or WeChat Mini Program (use ai-model-wechat).

59

web-development

TencentCloudBase

Web frontend project development rules. Use this skill when developing web frontend pages, deploying static hosting, and integrating CloudBase Web SDK.

514

ai-model-web

TencentCloudBase

Use this skill when developing browser/Web applications (React/Vue/Angular, static websites, SPAs) that need AI capabilities. Features text generation (generateText) and streaming (streamText) via @cloudbase/js-sdk. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended) and DeepSeek (deepseek-v3.2 recommended). NOT for Node.js backend (use ai-model-nodejs), WeChat Mini Program (use ai-model-wechat), or image generation (Node SDK only).

13

auth-http-api-cloudbase

TencentCloudBase

Use when you need to implement CloudBase Auth v2 over raw HTTP endpoints (login/signup, tokens, user operations) from backends or scripts that are not using the Web or Node SDKs.

17

You might also like

telegram-dev

2025Emma

Telegram 生态开发全栈指南 - 涵盖 Bot API、Mini Apps (Web Apps)、MTProto 客户端开发。包括消息处理、支付、内联模式、Webhook、认证、存储、传感器 API 等完整开发资源。

232

shopify-apps

alinaqi

Shopify app development - Remix, Admin API, checkout extensions

19

ccxt-typescript

ccxt

CCXT cryptocurrency exchange library for TypeScript and JavaScript developers (Node.js and browser). Covers both REST API (standard) and WebSocket API (real-time). Helps install CCXT, connect to exchanges, fetch market data, place orders, stream live tickers/orderbooks, handle authentication, and manage errors. Use when working with crypto exchanges in TypeScript/JavaScript projects, trading bots, arbitrage systems, or portfolio management tools. Includes both REST and WebSocket examples.

15

rdc-endpoint-setup

reactive

Set up @data-client/endpoint for custom async operations. Wraps existing async functions with Endpoint for use with Data Client hooks. Use after rdc-setup detects non-REST/GraphQL async patterns.

15

query-layer

EpicenterHQ

Query layer patterns for consuming services with TanStack Query, error transformation, and runtime dependency injection. Use when implementing queries/mutations, transforming service errors for UI, or adding reactive data management.

11

gemini-live-api-dev

LowyShin

Guides the usage of the Gemini Live (Multimodal Live) API using the Gen AI SDK. Use when the user asks about real-time, bidirectional streaming of voice and video with Gemini. Covers configuration, session management, sending/receiving audio/video media, and tool integration.

00

Search skills

Search the agent skills registry