Agent skill

Wecomcli Shared

by Pinvou in Pinvou/pinvou-agent

何时用:任何 wecomcli- 技能准备执行 wecom-cli 命令前必须同时读取本技能(公共前置检查),本技能不处理具体业务请求。检查 CLI 已安装且版本 ≥1.2.1、企微凭证已授权(缺失时按品悟代管口径引导,勿自行 npm 安装);获取机器人/授权真人身份(identity whoami);定义通用的 ID 类字段禁止外露输出约束。

MITAuto-check passedDocuments & Office

Install Wecomcli Shared

skills CLI
$ npx skills add Pinvou/pinvou-agent --skill wecomcli-shared -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Pinvou/pinvou-agent wecomcli-shared --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-shared .claude/skills/wecomcli-shared && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wecomcli-shared
GitHub stars
2.4k
Token cost
~582 tokens
SKILL.md length
125 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

何时用:任何 wecomcli- 技能准备执行 wecom-cli 命令前必须同时读取本技能(公共前置检查),本技能不处理具体业务请求。检查 CLI 已安装且版本 ≥1.2.1、企微凭证已授权(缺失时按品悟代管口径引导,勿自行 npm 安装);获取机器人/授权真人身份(identity whoami);定义通用的 ID 类字段禁止外露输出约束。

  • Works in 3 steps: :检查 CLI 安装与版本 → :检查授权状态 → :初始化凭证(仅未授权时)
  • Documents & Office work in your project
  • SKILL.md covers Step 1:检查 CLI 安装与版本, Step 2:检查授权状态, Step 3:初始化凭证(仅未授权时) and 通用输出约束:ID 类字段禁止外露, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Wecomcli Shared is an agent skill from Pinvou/pinvou-agent. 何时用:任何 wecomcli- 技能准备执行 wecom-cli 命令前必须同时读取本技能(公共前置检查),本技能不处理具体业务请求。检查 CLI 已安装且版本 ≥1.2.1、企微凭证已授权(缺失时按品悟代管口径引导,勿自行 npm 安装);获取机器人/授权真人身份(identity whoami);定义通用的 ID 类字段禁止外露输出约束。

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office. It works with npm. The repository describes itself as: Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/wecomcli-shared”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. :检查 CLI 安装与版本
  2. :检查授权状态
  3. :初始化凭证(仅未授权时)

What it can do on your machine

Read from SKILL.md and the folder at commit 7bba3ef. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wecomcli Shared loads about 582 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 125 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~582

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Pinvou/pinvou-agent at commit 7bba3ef, republished under its MIT licence (© Pinvou). 125 words, ~582 tokens.

Download SKILL.mdSave it as .claude/skills/wecomcli-shared/SKILL.md (or your agent's skills folder).
name
wecomcli-shared
description
何时用:任何 wecomcli-* 技能准备执行 wecom-cli 命令前必须同时读取本技能(公共前置检查),本技能不处理具体业务请求。检查 CLI 已安装且版本 ≥1.2.1、企微凭证已授权(缺失时按品悟代管口径引导,勿自行 npm 安装);获取机器人/授权真人身份(identity whoami);定义通用的 ID 类字段禁止外露输出约束。

wecom-cli 公共前置检查

本技能提供所有 wecomcli-* 业务技能共用的 CLI 安装、版本与授权检查,以及通用输出约束。每次准备执行任意 wecom-cli 命令前,先完成本技能;检查通过后,再回到对应业务技能执行。

本技能不能代替具体业务技能。处理联系人、文档、表格、日程、会议、待办、邮件、微盘、消息或媒体请求时,必须同时读取对应业务技能。

Step 1:检查 CLI 安装与版本

bash
wecom-cli --version
  • 命令成功,且输出中的版本号不低于 1.2.1 → 继续 Step 2。
  • 命令不存在、执行报错或版本号低于 1.2.1 → 不要自行安装或升级:wecom-cli 由品悟应用代为安装与管理,随应用更新自动就位。此时提示用户在品悟「插件中心 → 企业微信」卡片重新点「连接」,由品悟触发安装/升级;完成后重新执行 wecom-cli --version 复查。

仍失败或版本仍低于 1.2.1 时停止业务操作,并把错误告知用户。

Step 2:检查授权状态

bash
wecom-cli auth show --status
  • 输出 authorized → 前置检查完成,可以执行具体业务命令。
  • 输出 unauthorized → 执行 Step 3。
  • 命令报错或输出不是上述状态 → 停止业务操作,并把错误告知用户,不要猜测授权状态。

Step 3:初始化凭证(仅未授权时)

初始化命令是 wecom-cli auth init --noninteractive:它会展示授权链接和二维码,并阻塞等待用户使用企业微信扫码,授权成功后命令自动退出,仅需初始化一次。

不要在会话内直接执行该命令:会话内的调用会阻塞到扫码完成或超时,用户在此期间看不到二维码。请把该命令交给用户在自己的终端执行,或引导用户使用应用的连接入口完成授权;等用户确认已完成扫码后再继续。

初始化完成后重新执行:

bash
wecom-cli auth show --status

仅当输出 authorized 时,才能继续执行具体业务命令。

通用输出约束:ID 类字段禁止外露

本约束对所有 wecomcli-* 技能生效,优先级高于各业务技能的输出格式,且不因用户主动索要而放宽。

  • 禁止:你的最终回复禁止出现 userid / open_vid / department_id / chat_id 等 ID 标识。凡是接口返回的内部标识(含 mail_id / media_id / file_id / space_id / folder_id / docid / content_id / msg_id / cursor / next_cursor 等,命名上以 _id 结尾或语义上属于机器标识的字段一律视为 ID)都只能在内部流转,用于后续接口调用。
  • 必须:你的思考过程和最终回复必须使用可读名称,如 name / username / external_username / 部门名 / 邮箱 / subject / doc_name / chat_name / title 等 tool_result 返回的内容。
  • 接口只返回 ID 而没有可读名称时,先调用对应技能(如 wecomcli-contact 解析人员)换取可读名称;确实无法换取时,用自然语言描述该对象(如「上一封日报邮件」「你刚上传的那个文件」)来指代,禁止退化为展示 ID。
  • 需要用户在多个候选中选择时,用序号 + 可读信息(名称 / 主题 / 时间 / 路径等)构造候选列表,禁止用 ID 作为区分依据让用户辨认。
  • 用户直接要求「把 ID 给我」「打印 mail_id」时,说明该标识属于内部字段不便提供,并改用可读信息或继续帮其完成实际操作。
  • 可读链接(如文档 doc_url、微盘分享链接)不属于本约束限制范围,可按各业务技能规定正常展示,即使链接本身包含标识字符串。

执行规则

  • 已安装、版本达标且已授权时,不重复安装或初始化。
  • 安装、升级、初始化或复查失败时,不执行后续业务命令。
  • 本技能不定义任何联系人、文档、表格、日程、会议、待办、邮件、微盘、消息或媒体接口参数;具体命令必须回到对应业务技能读取。
  • 执行任何业务命令并组织回复时,同时遵守上方「通用输出约束:ID 类字段禁止外露」。

获取个人身份

如果操作流程必须获取机器人或授权人身份(姓名、userid等),需要调用 wecom-cli identity whoami 获取。

© Pinvou, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-shared of Pinvou/pinvou-agent.

Open the folder on GitHubat commit 7bba3ef

Compare with similar skills

Wecomcli Shared next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wecomcli Shared compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wecomcli Shared this skillPinvou/pinvou-agent2.4k—~582Automated safety check: PassMIT
HTML Slide To PPTXmucsbr/ppt-agent-workflow-san643—~1.1kAutomated safety check: PassNone
Creatpptseekskyworld/CreatPPT148—~2.7kAutomated safety check: PassApache-2.0
Sunat CLIcrafter-research/sunat-cli104—~5.7kAutomated safety check: PassMIT
Find Skillsfastclaw-ai/fastclaw1.4k—~2.3kAutomated safety check: WarnCustom licence
Kai Slide Creatorwentorai/Research-Claw858—~1kAutomated safety check: PassCustom licence

Similar skills

  • HTML Slide To PPTX

    mucsbr/ppt-agent-workflow-san

    Convert structured single-slide or small deck HTML files into editable PPTX slides with native text boxes, shapes, chips, arrows, and panels.

    643 GitHub stars~1.1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Creatppt

    seekskyworld/CreatPPT

    Generate a finished editable Web presentation workspace from a brief or semantic content, then let the user revise it in the browser and explicitly export PPTX on demand.

    148 GitHub stars~2.7k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Sunat CLI

    crafter-research/sunat-cli

    SUNAT tax automation CLI for Peru. An agent skill from crafter-research/sunat-cli.

    104 GitHub stars~5.7k tokensUpdated 24 days ago
    Documents & OfficeAuto-check passed
  • Find Skills

    fastclaw-ai/fastclaw

    Run this BEFORE any package install (pip / npm / apt / brew / cargo / gem / go install) you would otherwise execute via the exec tool — including when the user asks for a deliverable that needs…

    1.4k GitHub stars~2.3k tokensUpdated 2 days ago
    Documents & OfficeAuto-check: warnings
  • Kai Slide Creator

    wentorai/Research-Claw

    Generate zero-dependency HTML presentations that run entirely in the browser.

    858 GitHub stars~1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Nexus Mobile Compat

    ProfSynapse/nexus

    Keep Nexus loading on mobile and compliant with the Obsidian plugin store — vet a dependency, import without crashing init, confine a vault path, and prove none of it regressed with the reachability…

    157 GitHub stars~1.2k tokensUpdated today
    Documents & OfficeAuto-check passed

More from Pinvou/pinvou-agent

All 30 skills in this repo
  • Tmeet Skill

    Pinvou/pinvou-agent

    何时用:用户明确要通过命令行操作腾讯会议(tmeet),或 Agent 遇到工具缺失/调用失败/能力不足想反馈平台时。OAuth 登录/登出/状态、会议管理(创建/更新/取消/查询/搜索/受邀者)、录制管理(列表/播放地址/智能纪要/转写/权限申请)、元宝纪要(按关键词/时间搜索、稳态/瞬态详情)、会议报告(参会人/等候室/导出明细/异步任务)、通讯录(仅限会议邀请/呼叫入会前置解析,严禁单独查…

    2.4k GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Wecomcli Doc

    Pinvou/pinvou-agent

    何时用:仅当用户明确指定 doc/docx/word/在线文档/office文档或提供 doc.weixin.qq.com/doc/ 链接时使用;泛指「做个文档/写文档/整理成文档」默认走 wecomcli-smartpage 或本地工具,本技能不得抢占。doc 内容操作:新建、导入(.doc/.docx/.txt)、读取、追加、覆盖写入;结构化数据需求改用智能文档/智能表格;公共管理走…

    2.4k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Dws

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/AI听记/邮箱/在线电子表格(axls)/知…

    2.4k GitHub stars~5.3k tokensUpdated today
    Auto-check passed
  • Lark Im

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive…

    2.4k GitHub stars~5.9k tokensUpdated today
    Auto-check passed
  • Lark Sheets

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark 电子表格;泛指做表格默认走本地工具】创建/操作飞书电子表格:工作表与行列结构、读写单元格(值/公式/样式/批注/图片)、查找替换、批量更新、图表/透视表/条件格式/筛选/迷你图/浮动图片。按名称搜索云空间表格文件改用 lark-drive 的 drive +search。doubao.com 的 /sheets/ URL 也走本 skill。不适用本地…

    2.4k GitHub stars~6.5k tokensUpdated today
    Auto-check passed
  • Lark Base

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、BaseApp 应用模式(页面与组件)、Workspace 目录、workflow、角色权限、模板中心(模板分类/列表/搜索);遇到…

    2.4k GitHub stars~4k tokensUpdated today
    Auto-check passed

Works with

Questions about Wecomcli Shared

What does Wecomcli Shared do?

何时用:任何 wecomcli- 技能准备执行 wecom-cli 命令前必须同时读取本技能(公共前置检查),本技能不处理具体业务请求。检查 CLI 已安装且版本 ≥1.2.1、企微凭证已授权(缺失时按品悟代管口径引导,勿自行 npm 安装);获取机器人/授权真人身份(identity whoami);定义通用的 ID 类字段禁止外露输出约束。. Wecomcli Shared is an agent skill from Pinvou/pinvou-agent.

When should I use Wecomcli Shared?

Wecomcli Shared fits situations like: documents & Office work in your project.

How do I install Wecomcli Shared in Claude Code?

Run `npx skills add Pinvou/pinvou-agent --skill wecomcli-shared -a claude-code`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-shared in Pinvou/pinvou-agent) into .claude/skills/wecomcli-shared in your project. Claude Code loads it when a task matches its description.

How do I install Wecomcli Shared in Codex?

Run `npx skills add Pinvou/pinvou-agent --skill wecomcli-shared -a codex`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-shared in Pinvou/pinvou-agent) into .agents/skills/wecomcli-shared in your project. Codex loads it when a task matches its description.

Can I use Wecomcli Shared in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Pinvou/pinvou-agent --skill wecomcli-shared -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wecomcli-shared, .gemini/skills/wecomcli-shared, .github/skills/wecomcli-shared and .opencode/skills/wecomcli-shared in your project.

What does Wecomcli Shared need to run?

SKILL.md names no scripts, command-line tools or credentials: Wecomcli Shared is instructions for the agent only.

Does Wecomcli Shared access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wecomcli Shared safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Wecomcli Shared use?

Wecomcli Shared is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wecomcli Shared use?

About 582 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Wecomcli Shared?

Skills that share tags, products or a category with Wecomcli Shared: HTML Slide To PPTX (mucsbr/ppt-agent-workflow-san, 643 stars), Creatppt (seekskyworld/CreatPPT, 148 stars), Sunat CLI (crafter-research/sunat-cli, 104 stars) and Find Skills (fastclaw-ai/fastclaw, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wecomcli Shared?

Pinvou (a GitHub organization) maintains it in Pinvou/pinvou-agent, which has 2,401 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 9, 2026.

Source: Pinvou/pinvou-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.