WeCom Unified skill
wecom-unified
A skill giving the agent 13 WeCom business areas: contacts, documents, spreadsheets, calendar, meetings, tasks, drive and mail
- 131 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent sends mail and messages and edits documents and the calendar on behalf of the account owner
- The skill reads the address book, mail and files on the company drive
- Sign-in is a `wecom-cli` authorization that stays on the machine until revoked
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/wecom-unifiedDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent sends mail and messages and edits documents and the calendar on behalf of the account owner
- The skill reads the address book, mail and files on the company drive
- Sign-in is a `wecom-cli` authorization that stays on the machine until revoked
This is third-party code. Review the repository files before installing.
What it does
The WeCom Unified skill connects an agent to the WeCom (企业微信) corporate messenger through the `wecom-cli` command-line program. `SKILL.md` works as a routing table. The agent decides which area a request belongs to, opens that area's reference in the `references/` folder and only then builds a command instead of inventing parameters from memory. The areas cover address book lookup, online documents, spreadsheets and smart sheets, smart documents, presentations with `.ppt` and `.pptx` import, a calendar with availability and meeting room checks, meetings with minutes and transcripts, tasks, cloud drive, mail and bot messages with text, files, voice and video. Before the first call the skill checks that `wecom-cli` version 1.2.1 or newer is installed and authorized. If not, it installs the `@wecom/cli` package and starts a QR-code sign-in. The skill must not show internal IDs in replies to the user.
Who it is for. Staff of companies on WeCom who want to run meetings, documents and tasks through an agent in Codex, Cursor or other supported environments.
Good fit when
- A colleague has to be found by name or pinyin and given a calendar meeting right away
- A link on `doc.weixin.qq.com` holds a document or sheet that the agent has to read and update
- Meeting results have to become tasks with assignees and deadlines
- A local `.pptx` presentation has to be imported as an online document and handed over as a link
- A file has to be uploaded to the cloud drive or found there by name
Not a fit when
- The company does not use WeCom: the skill works only through `wecom-cli` and sign-in to that service
- You need personal WeChat: the skill covers corporate WeCom
- There is no way to scan the authorization QR code on the agent's machine
Example request
Find Li Ming in WeCom, create a meeting with him tomorrow at 11:00 and put a link to the agenda document in the invitationLimitations
Node.js 18 or newer and a WeCom account are required. The first connection blocks until a person scans the QR code. The skill itself is a set of instructions and the actions are carried out by `wecom-cli` version 1.2.1 or higher. The references and descriptions are written in Chinese. If the user does not specify a type, the skill creates a smart document instead of a plain document and a smart sheet instead of a plain sheet. macOS, Linux and Windows are supported, with x64 and arm64 on macOS and Linux.
How to disable. Remove the skill through the `skills` manager or its folder in the agent's directory. To revoke access, drop the `wecom-cli` authorization and remove the app's access in WeCom settings. The package is removed with `npm uninstall -g @wecom/cli`.
FAQ
How do I install WeCom Unified in Codex or Cursor?
Run `npx skills add WecomTeam/wecom-unified -y -g`: the command finds installed supported environments, including WorkBuddy, CodeBuddy, MiniMax Code, Kimi Work, Codex and Cursor.
How does the skill get access to WeCom?
Through `wecom-cli auth init --noninteractive`: the command prints a link and a QR code and waits until the account owner confirms sign-in. Check the status with `wecom-cli auth show --status`.
What if `wecom-cli` is not found?
The skill itself runs `npm install -g @wecom/cli`. If the version stays below 1.2.1 after installing, it stops and reports the error to the user.
How does this skill differ from `wecom-cli` itself?
`wecom-cli` runs the commands, while the skill holds routing across 13 areas and parameter references the agent uses to build those commands.
Does the skill show internal identifiers?
No, a general constraint in `SKILL.md` forbids printing identifier fields in the reply to the user.
Discussion
No questions or reviews yet.
Related
SkillsWeCom CLI
wecom-cli
The official WeCom CLI with 15 agent skills: messages, docs, calendar, meetings, mail and disk from the terminal
A library of 229 skills for work and life: sales, marketing, finance, engineering, design and parallel agent runs
DingTalk Workspace CLI (dws)
DingTalk Workspace CLI
Official DingTalk CLI with agent skills: chats, calendar, todos, mail, docs and approvals of your organization from the terminal
Claude-to-IM
claude-to-im
A bridge between Claude Code or Codex and messengers: talk to the agent from Telegram, Discord, Feishu, QQ or WeChat
Nine local skills for steering an agent's work: goal clarification, a task forest, pause and session handoff, skill engineering
A skill that lets an agent join a Google Meet, Teams or Zoom call with voice, an avatar, screen sharing and live transcription
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| WeCom Unified (this card) | yes | 131 | |
| WeCom CLI | yes | 3,305 | the command-line program and its skills, while this is a single skill with routing across 13 areas and references |
| DingTalk Workspace CLI (dws) | yes | 3,935 | a CLI for DingTalk, while this covers the WeCom corporate messenger |
README in short
The README, written in Chinese, presents the project as a set of WeCom CLI capabilities for agents. It includes a table of areas with examples, prerequisites, an install command for several environments, the repository layout and the MIT license. At the bottom is an invitation to the community chat.
README badge
Original SKILL.md
--- name: wecom-unified description: "企业微信全能套件,覆盖通讯录、文档、在线表格、智能表格、智能文档、PPT 演示文稿、日程、会议、待办、微盘、邮件、消息、媒体文件等业务域。链接包含 doc.weixin.qq.com 或 page.weixin.qq.com 必触发。提及企业微信或命中以下功能必触发:查找联系人信息。搜索、重命名和授权文档,新建与读写 doc 在线文档,创建与修改在线表格及处理本地 Excel / CSV / TSV 文件,创建/导入并读写智能表格的子表/字段/记录/视图/图表及填色、高亮等样式,创建与编辑智能文档(含表单和数据看板),生成与编辑在线 PPT 演示文稿、把本地 .ppt/.pptx 导入为在线文档(交付在线文档链接),创建/查询/修改/取消日程并查询闲忙、办公楼和会议室,预约与管理在线会议(含纪要、待办与转写原文),创建/查询/修改/完成/删除或退出待办,搜索和上传微盘文件、下载离线文件、重命名支持的文件及新建文件夹,发送/回复/转发与搜索阅读邮件,向当前授权人或最近活跃会话发送文本/Markdown/图片/文件/语音/视频消息,以及上传下载媒体文件。即使未明确提到「企业微信」,只要涉及找人/文档/表格/日程/会议/待办/微盘/邮件/发消息等办公场景,也应触发本技能;「做个PPT/生成演示文稿/汇报PPT/导入PPT」等表述同样触发。未指定类型的「文档」默认使用智能文档;未明确「在线表格」的「表格」默认使用智能表格。链接包含 drive.weixin.qq.com 必触发" allowed-tools: Bash, Read --- # 企业微信套件 (WeCom Unified) 企业微信 CLI (`wecom-cli`) 全能套件,通过命令行工具与企业微信系统交互。下方「业务域概览」是路由表:判断用户意图属于哪个业务域,然后读取该域对应的 reference 文件,再按其中的参数规范构造命令。严禁凭路由表描述或自身记忆猜测拼参数。 ## ⚠️ 前置检查 — 使用任何命令前必须执行 ### Step 1: 检查 CLI 是否安装和版本号是否为 1.2.1 或更高版本 ```bash wecom-cli --version ``` 如果命令不存在或报错,执行安装,如果版本号小于 1.2.1 同样要执行安装: ```bash npm install -g @wecom/cli ``` 安装完成后重新执行 `wecom-cli --version`;仍失败或版本仍低于 `1.2.1` 时停止业务操作,并把错误告知用户。 ### Step 2: 检查凭证是否配置 ```bash wecom-cli auth show --status ``` - 输出 `authorized` → 已配置,可以继续使用 - 输出 `unauthorized` → 未配置,需要执行 Step 3 - 命令报错或输出不是上述状态 → 停止业务操作,并把错误告知用户,不要猜测授权状态 ### Step 3: 配置凭证(仅未授权时执行) ```bash wecom-cli auth init --noninteractive