About

Imported from starchild-ai-agent/official-skills (wechat-binding/SKILL.md) via skills.sh. Install upstream with npx skills add starchild-ai-agent/official-skills --skill wechat-binding. Copyright stays with the author.

📱 WeChat Binding

Name: wechat-binding
Author: starchild-ai-agent

Connect / reconnect / disconnect the user's WeChat account so the agent can push messages via send_to_wechat.

The wechat tool stays built-in. This SKILL.md is the reference doc.

Typical binding flow

qrcode → user scans → qrcode_status(qrcode=...) → connect(bot_token=...)

Generate QR: wechat(action="qrcode") — saves an image to workspace, returns qrcode (id) + file_path.
Show the QR to the user. On web channel: include the file_path so the frontend renders the image. On TG/WeChat channel: send the image via send_to_telegram with the file_path.
Wait for the user to scan + confirm in WeChat. Don't auto-poll — let them say "scanned" / "done" first.
Poll for completion: wechat(action="qrcode_status", qrcode=<id from step 1>). Returns bot_token once scan + confirm completes.
Connect: wechat(action="connect", bot_token=<from step 4>). Optional: ilink_bot_id, ilink_user_id if the user has multiple WeChat accounts.
Confirm to user: "WeChat connected. You can now push messages with send_to_wechat."

Actions

action	required	purpose
`status`	—	Current WeChat connection state. Use before reconnect, to verify binding.
`qrcode`	—	Generate QR code image (saved to workspace). Returns `qrcode` id + `file_path`.
`qrcode_status`	`qrcode`	Poll whether user has scanned + confirmed. Returns `bot_token` on success.
`connect`	`bot_token`	Complete a NEW WeChat connection (after first-ever QR scan). Optional: `ilink_bot_id`, `ilink_user_id`.
`disconnect`	—	Terminate current WeChat session (unlink).
`reconnect`	`bot_token`	Re-establish a previously-bound WeChat (token from a fresh QR scan).

connect vs. reconnect

connect — first-time binding. The user has NEVER bound this WeChat before.
reconnect — the user was previously connected, the connection dropped (e.g. ilink session expired), and they just scanned a fresh QR.

When in doubt, call status first:

connected: false + no prior history → connect
connected: false + prior history exists → reconnect

Channel-aware QR display

User channel	How to show the QR
Web	Include `file_path` in your reply — frontend renders it inline
Telegram	`send_to_telegram(file_path=<qr_path>, message_type="photo")`
WeChat	(You can't — they're trying to bind WeChat in the first place. Tell them to open the web app.)

Critical rules

Don't auto-poll qrcode_status after qrcode. Wait for user confirmation that they scanned + confirmed in WeChat. Auto-polling spams the upstream API.
Each qrcode call generates a fresh image. Don't re-use an old qrcode id with a new image — the upstream session is tied to the id.
Never paste bot_token in chat. It's a credential. Once you have it from qrcode_status, immediately pass it to connect / reconnect and don't echo it back to the user.
disconnect is destructive — confirm with the user before calling it.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/starchild-ai-agent-official-skills-wechat-binding/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

starchild-ai-agent-official-skills-wechat-binding.ocm.jsonjson

{
  "ocm": "1",
  "id": "starchild-ai-agent-official-skills-wechat-binding",
  "kind": "skill",
  "name": "wechat-binding",
  "description": "WeChat binding: QR scan, bind, unbind, reconnect, status check. Use when setting up or repairing WeChat delivery (e.g. connect WeChat, scan QR, why isn't WeChat pushing, disconnect WeChat).",
  "publisher": "starchild-ai-agent",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "customer_support"
    ],
    "tags": [
      "skill-md",
      "wechat",
      "binding",
      "connection",
      "qrcode",
      "ilink",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "WeChat binding: QR scan, bind, unbind, reconnect, status check. Use when setting up or repairing WeChat delivery (e.g. connect WeChat, scan QR, why isn't WeChat pushing, disconnect WeChat)."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/starchild-ai-agent/official-skills",
      "path": "wechat-binding/SKILL.md",
      "ref": "HEAD",
      "url": "https://www.skills.sh/starchild-ai-agent/official-skills/wechat-binding",
      "key": "starchild-ai-agent/official-skills/wechat-binding/SKILL.md"
    }
  },
  "instructions": "# 📱 WeChat Binding\n\nConnect / reconnect / disconnect the user's WeChat account so the agent can push messages via `send_to_wechat`.\n\nThe `wechat` tool stays built-in. This SKILL.md is the reference doc.\n\n## See also\n- `config/context/references/messaging-channels.md` — how to actually send messages once bound\n- `skills/tg-bot-binding/SKILL.md` — analogous Telegram flow\n\n---\n\n## Typical binding flow\n\n```\nqrcode → user scans → qrcode_status(qrcode=...) → connect(bot_token=...)\n```\n\n1. **Generate QR:** `wechat(action=\"qrcode\")` — saves an image to workspace, returns `qrcode` (id) + `file_path`.\n2",
  "cost": {
    "context_tokens": 821
  }
}

Fetch it by URL: GET /api/v1/registry/starchild-ai-agent-official-skills-wechat-binding/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.