# wechat-binding

A skill that walks the agent through WeChat binding: QR generation, scan, connect, reconnect and disconnect.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2200 installs · ★ 29
- Author: starchild
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/wechat-binding/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/wechat-binding

## What it does

Reach for this skill when the agent needs to push messages with `send_to_wechat` but the account isn't linked yet, or the link broke. The `wechat` tool itself is built in; SKILL.md is the reference for its actions: `status`, `qrcode`, `qrcode_status`, `connect`, `disconnect`, `reconnect`.

The flow runs in order. The agent calls `wechat(action="qrcode")`, gets an image plus a file path, you scan it in WeChat and confirm. Then the agent polls `qrcode_status` with the code id, picks up a `bot_token`, and hands it to `connect` or `reconnect`. Don't poll on a loop — every status call hits the upstream API, so the skill tells the agent to wait until you say the scan is done.

Where the QR shows up depends on your channel. On the web the file path goes into the reply and the frontend renders the image. In Telegram the image ships through `send_to_telegram` as a photo. Binding WeChat from inside WeChat won't work at all; you have to open the web app. Treat `bot_token` as a credential and keep it out of chat, and remember that `disconnect` kills the session with no undo — worth confirming before it runs.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill wechat-binding -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/wechat-binding/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/wechat-binding/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill wechat-binding -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/wechat-binding/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill wechat-binding -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/wechat-binding/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills wechat-binding
```

2. **Manually: put the files in place**
- File: `.github/skills/wechat-binding/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill wechat-binding -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path wechat-binding
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/wechat-binding/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill wechat-binding -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/wechat-binding/SKILL.md

## When to use it
- bind a WeChat account to the agent by scanning a QR code
- restore delivery after an ilink session expires
- check whether WeChat is already bound before reconnecting
- unlink WeChat once push messages are no longer wanted
- render the QR inline on web or send it as a photo in Telegram

## Example prompts
- Connect WeChat: generate the QR code and show me the image
- I scanned the code, check the status and finish the binding
- WeChat stopped pushing messages — check the status and reconnect

## Similar
- [wechat-article-extractor](https://affpapa.org/en/nevibecode/skills/wechat-article-extractor.md) — skill · 3900 installs
- [baoyu-wechat-summary](https://affpapa.org/en/nevibecode/skills/baoyu-wechat-summary.md) — skill · 9800 installs
- [baoyu-post-to-wechat](https://affpapa.org/en/nevibecode/skills/baoyu-post-to-wechat.md) — skill · 34400 installs
- [auth-wechat-miniprogram](https://affpapa.org/en/nevibecode/skills/auth-wechat-miniprogram.md) — skill · 2200 installs
- [cloudbase-document-database-in-wechat-miniprogram](https://affpapa.org/en/nevibecode/skills/cloudbase-document-database-in-wechat-miniprogram.md) — skill · 1500 installs
- [wechat-miniprogram-skill](https://affpapa.org/en/nevibecode/skills/wechat-miniprogram-skill.md) — skill · 1400 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md