Skip to content
Skills Library
Personal productivity · Tool integration

wechat-setup

/wechat-setup

First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or

Licence
Apache-2.0
Last repository change
31.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 31.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or

Triggers from the description

set up wechatwechat doctorwhy doesnpermissions for wechatscreen lockedmain window did not appear
Original author description

First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or

How it works

  1. 1. Build and run the doctor
  2. 2. Permissions (only the user can grant these)
  3. 3. Config
  4. 4. Calibrate the window
  5. 5. First send, to yourself
  6. Keeping it healthy
Original SKILL.md headings · 62 lines, 455 words
SKILL.md preview
---
name: wechat-setup
description: First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run send to File Transfer. Use when the user installs the plugin, says "set up wechat", "wechat doctor", "why doesn't the wechat skill work", "permissions for wechat", or when any wechat-* command fails with blank screenshots, dropped clicks, "screen locked" or "main window did not appear". Not for sending (wechat-send) or campaigns (wechat-outreach).
---

Read `../shared/RULES.md` first.

# Set up and check

## 1. Build and run the doctor

```bash
./install.sh                 # builds bin/wxctl and bin/ocr, installs Pillow + openpyxl, creates config.toml
python3 -m wxmac.doctor      # read-only checklist with the fix for each failing item
```

Fix items top to bottom; rerun the doctor after each.

## 2. Permissions (only the user can grant these)

Grants belong to the app that runs the commands (Terminal, iTerm, or the app hosting Claude Code), not to the scripts.
Tell the user exactly where to click; you cannot do it for them:

| Permission | Where | Needed for |
|---|---|---|
| Accessibility | System Settings → Privacy & Security → Accessibility → turn on the terminal app | keys and clicks |
| Screen Recording | System Settings → Privacy & Security → Screen Recording → turn on the terminal app | reading the screen |
| Full Disk Access (optional) | System Settings → Privacy & Security → Full Disk Access → turn on the terminal app | replies, opt-outs from replies |

After granting, the terminal app must be restarted. Without Screen Recording, screenshots come back as the desktop
only and every name "does not match": that is the commonest first failure.

## 3. Config

`~/Library/Application Support/wechat-sales-copilot/config.toml` (created from `config.example.toml`).
Ask the user for: their name as contacts know them, company, one-line description, a few facts drafts may use, who
buys from them, what their WeChat tags mean. Fill `[persona]` and `[classify]`. Set `[ui] language` to the WeChat
interface language: `en` is tested; with `zh`, sending is tested but contacts capture is **unverified** (say so; run
`python3 -m wxmac.doctor --ocr` to confirm the language on screen). Leave `[pacing]` at the defaults unless the user insists.

## 4. Calibrate the window

```bash
bin/wxctl fit                # main window to the top-left, 1300 wide, full height
bin/wxctl windows            # any extra window titles are popped-out chats: bin/wxctl close-window "<title>"
```

The layout constants in `wxmac/wx_send.py` (`LIST_RIGHT`, `INPUT_TOP`, `PHONE_ICON`) assume this default layout.

## 5. First send, to yourself

```bash
python3 -m wxmac.wx_send "File Transfer" "setup test" --dry-run
python3 -m wxmac.wx_send "File Transfer" "setup test"
```

Both must print `dry-run` then `sent`. On a Chinese interface the chat is "文件传输助手". If it aborts, read the
`reason` and `docs/pitfalls.md`, and look at the newest screenshot in the data dir's `shots/`.

## Keeping it healthy

- The screen must stay unlocked while sending. The sender acts only when the user is away from the keyboard, so a
  short screen-saver delay plus "require password immediately" will lock it mid-run. Tell the user the trade-off;
  changing lock settings is their call.
- After a WeChat update, rerun the doctor and the File Transfer test before any campaign.

Versions

The database has no other skills named wechat-setup.

Database snapshot: 13.11.2026 · package version 2305a54b6497 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100wechat-send
    Send one WeChat message from the user's own WeChat for Mac to one person or one group - text, optionally followed by a picture or any file - or just open a chat to check it is the right one. Every step is verified on screen (search result in a chat section, chat header, text…
  • 95wechat-ops
    Keep WeChat for Mac in a state the scripts can drive - see what is on screen, list, resize and close WeChat windows, handle a locked screen, a logout or a WeChat update, and use the low-level wxctl primitives. Use for "WeChat window is wrong", "what is on the WeChat screen",…
  • 100wechat-send-file
    Send a file or image to WeChat via TeamMCP. Use when the user wants to send a file, image, or document to WeChat.
  • 100wechat-send-image
    Send an image or screenshot to WeChat. Use when the user wants to send a picture, screenshot, or photo to WeChat.
  • 100wechat
    在本地查询、导出微信 4.1+ 聊天记录为 AI 可读文本 —— 支持双人会话、群聊、以及按消息量排名的重要联系人排名。当用户想导出、搜索或分析自己的微信聊天记录,或为其他 skill(前任.skill / 同事.skill 等)准备聊天记录原材料时使用。
  • 100wechat-send
    用户在桌面微信里给某个群或个人发一条消息、不想自己动手点的时候使用。通过 Win32 截图/点击/剪贴板脚本操作微信客户端:恢复窗口 → 窗口截图量坐标 → 搜索会话 → 核对标题(群名带人数) → 输入内容(中文走剪贴板) → 点「发送」→ 截图确认气泡。同义说法:给群里发个消息、在XX群发一下、微信回他一句、发微信消息、微信自动发消息、桌面微信自动化、Windows 微信自动化、微信群发消息、微信定时发送。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.