Agent skill

Wecomcli Sheet

by Pinvou in Pinvou/pinvou-agent

何时用:仅当用户明确指向企业微信『在线表格』或提供 doc.weixin.qq.com/sheet/ 链接时使用;泛指做表格默认先按消歧确认,智能表格内容操作走 wecomcli-smartsheet,本地表格默认走本地工具。在线表格:新建、导入 CSV/Excel、读取信息与数据、修改内容、追加行、子表管理;文档公共操作走 wecomcli-doc-manage。

MITAuto-check passedDocuments & Office

Install Wecomcli Sheet

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

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

GitHub CLI
$ gh skill install Pinvou/pinvou-agent wecomcli-sheet --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-sheet .claude/skills/wecomcli-sheet && 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-sheet
GitHub stars
2.4k
Token cost
~1.2k tokens
SKILL.md length
319 words
Files
6 (incl. references)
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

何时用:仅当用户明确指向企业微信『在线表格』或提供 doc.weixin.qq.com/sheet/ 链接时使用;泛指做表格默认先按消歧确认,智能表格内容操作走 wecomcli-smartsheet,本地表格默认走本地工具。在线表格:新建、导入 CSV/Excel、读取信息与数据、修改内容、追加行、子表管理;文档公共操作走 wecomcli-doc-manage。

  • Works in 3 steps: 从文档链接提取(优先):用户提供了企微文档 URL 时,直接从 URL… → 通过文档搜索获取(备选):用户仅提供文档名称或关键词、未给链接时,先调用… → 用户直接提供:用户明确给出了完整 docid,可直接使用,无需再提取或搜索。
  • Tasks that involve Excel spreadsheets
  • SKILL.md covers 适用范围, 接口路由表, 写操作确认 and 接口详述, plus 1 more section
  • Reaches doc.weixin.qq.com

What it does

Wecomcli Sheet is an agent skill from Pinvou/pinvou-agent. 何时用:仅当用户明确指向企业微信『在线表格』或提供 doc.weixin.qq.com/sheet/ 链接时使用;泛指做表格默认先按消歧确认,智能表格内容操作走 wecomcli-smartsheet,本地表格默认走本地工具。在线表格:新建、导入 CSV/Excel、读取信息与数据、修改内容、追加行、子表管理;文档公共操作走 wecomcli-doc-manage。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/sheet-contents-update.md`, `references/sheet-ranges-get.md` and `references/sheet-rows-append.md`).

It sits in Documents & Office, covering Excel spreadsheets and CSV and tabular files. It works with Microsoft Excel and WeChat. 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

  • Tasks that involve Excel spreadsheets
  • Tasks that involve CSV and tabular files

Example prompts

  • “/wecomcli-sheet”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 从文档链接提取(优先):用户提供了企微文档 URL 时,直接从 URL 中解析。URL 格式为 https://doc.weixin.qq.com//?scode=...,取 // 后、? 前的部分即为 docid。
  2. 通过文档搜索获取(备选):用户仅提供文档名称或关键词、未给链接时,先调用 wecomcli-doc-manage 搜索文档,从返回结果中取 docid。
  3. 用户直接提供:用户明确给出了完整 docid,可直接使用,无需再提取或搜索。

What it can do on your machine

Read from SKILL.md and the folder at commit 76cb1db. 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

    Hosts in commands or code, which the agent is likely to contact:

    • doc.weixin.qq.com

    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 Sheet loads about 1.2k tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 319 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.1k

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 76cb1db, republished under its MIT licence (© Pinvou). 319 words, ~1,188 tokens.

Download SKILL.mdSave it as .claude/skills/wecomcli-sheet/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
wecomcli-sheet
description
何时用:仅当用户明确指向企业微信『在线表格』或提供 doc.weixin.qq.com/sheet/ 链接时使用;泛指做表格默认先按消歧确认,智能表格内容操作走 wecomcli-smartsheet,本地表格默认走本地工具。在线表格:新建、导入 CSV/Excel、读取信息与数据、修改内容、追加行、子表管理;文档公共操作走 wecomcli-doc-manage。

企业微信在线表格管理

执行任何 wecom-cli 命令前,必须先读取并完成 wecomcli-shared 技能的公共前置检查。

资源型 skill,负责在线表格(sheet)的新建、导入与内容读写及子表管理。

适用范围

适用
  • 新建 / 导入企微在线表格
  • 读取 / 修改 / 追加在线表格内容
  • 添加 / 删除在线表格子表
不适用
  • 搜索文档 / 修改文档权限 / 重命名 / 加成员 → 改用 wecomcli-doc-manage
  • 用户给的链接是 https://doc.weixin.qq.com/smartsheet/... → 改用 wecomcli-smartsheet
  • 若遇到的 docid 以 s3 开头(形如 s3_xxxx)→ 改用 wecomcli-smartsheet
  • 用户泛指「做表格」、未明确在线表格还是智能表格 → 先用简洁自然语言消歧确认,不得默认本技能

接口路由表

硬规则:第二列是 references/xxx.md 链接的, 命中这一行后先用 read 读取对应 references 文件,再构造命令。

用户意图参考位置
新建在线表格见下方「新建在线表格」
导入本地 CSV / Excel 文件为企微在线表格见下方「导入在线表格」
读取在线表格基础信息与子表列表见下方「读取在线表格」
读取在线表格子表数据references/sheet-ranges-get.md
修改在线表格指定区域内容references/sheet-contents-update.md
在线表格末尾追加一行数据references/sheet-rows-append.md
添加在线表格子工作表references/sheet-subsheets-add.md
删除在线表格子工作表references/sheet-subsheets-delete.md

写操作确认

  • 删除子表(sheet-subsheets-delete)与 contents update 覆写前,必须向用户复述影响范围并获得明确确认。

接口详述

新建在线表格

从零新建一篇企微在线表格:空白,或带初始数据(二维表格数据)。本接口不接受任何文件路径参数——"用本地文件建/导入"走「导入在线表格」。

命令
bash
wecom-cli sheet create --json '<JSON 参数>'
参数
字段类型必填默认值语义
doc_namestring是—表格标题
grid_dataobject否—默认子表初始化数据;子结构见下方

grid_data 对象结构:

子字段类型必填默认值语义
start_row / start_columnint否0起始行 / 列号,从 0 起
rowsarray否—各行数据;每项 values 为单元格数组
rows[].values[].cell_valueobject否—单元格值,见下方「cell_value 类型选择」
rows[].values[].data_typestring否—枚举:TEXT / NUMBER / LINK / FORMULA
cell_value 类型选择

硬规则:选择 cell_value 形态后,必须同时把同级的 data_type 设置为下表对应值。

形态对应 data_type结构适用场景
textTEXT{"text": "<纯文本>"}纯文本内容(如姓名、说明、标签、编号字符串等)
numberNUMBER{"number": 123.45}数值,用于金额、数量、比率等需要参与公式计算或聚合的数据;值为 JSON 数字类型,不加引号
formulaFORMULA{"formula": "=SUM(A1,A2)"}任何以 = 开头的公式,包括 =SUM(...)、=A1+B1、=IF(...)、=VLOOKUP(...) 等
linkLINK{"link": {"url": "<URL>", "text": "<显示文本>"}}超链接
返回
字段类型说明
docidstring新建表格 ID
urlstring表格访问链接
使用规则
  • 何时走 import 而非本接口:用户提到具体文件路径、或明确说"导入 / 用这个文件建",一律走「导入在线表格」。
导入在线表格

把本地文件(.csv / .xls / .xlsx)导入为企微在线表格。

命令
bash
wecom-cli sheet import --json '<JSON 参数>'
参数
字段类型必填默认值语义
file_namestring是—二进制文件名(含后缀),用于业务判断源文件类型
file_pathstring是—源文件的本地绝对路径
passwdstring否—Office 文件加密密码(若有)
返回
字段类型说明
docidstring导入完成后的表格 ID
urlstring导入完成后的访问链接
task_statusstring任务状态枚举,如 succ 成功
读取在线表格

根据 docid 读取在线表格的基础信息,包括工作表列表、文档名称与访问链接。所有后续 sheet * 接口的 sheet_id 都从本接口返回的 sheets[] 中取。

命令
bash
wecom-cli sheet get --json '<JSON 参数>'
参数
字段类型必填默认值语义
docidstring是—在线表格 ID
返回
字段类型说明
sheetsarray工作表列表;每项含 sheet_id / title / row_count / column_count / data_range 等基础信息
urlstring文档访问链接
namestring文档名称
使用规则
  • 拿到 sheet_id 后继续读取子表数据是另一个接口,命令字符串、参数名、是否分页等都没有在本节出现,必须先用 read 读 references/sheet-ranges-get.md,再据此构造命令。

跨技能依赖

依赖技能典型协作场景数据流向
wecomcli-doc-manage用户只给表格名称/关键词,需搜索获取 docid 后再读写表格;或需要文件级操作(改名、权限等)wecomcli-doc-manage 的「搜索文档」接口 → 返回 docid → 本 skill 的读取/修改/追加接口

必填参数缺失 / docid 多候选 / 新建 vs 导入等歧义场景,用简洁自然语言仅追问缺失或有歧义的信息;有候选项时在文字中列出供用户选择,不得自行猜测。

docid 使用规则

docid仅cli使用。 最终展示用户时,不应展示 docid,而是使用文档 URL:

[doc_name](doc_url)

docid 是文档的唯一标识符,调用任何文档内容操作技能时均需提供。禁止自造 docid,按以下优先级获取:

  1. 从文档链接提取(优先):用户提供了企微文档 URL 时,直接从 URL 中解析。URL 格式为 https://doc.weixin.qq.com/<type>/<docid>?scode=...,取 /<type>/ 后、? 前的部分即为 docid。
  2. 通过文档搜索获取(备选):用户仅提供文档名称或关键词、未给链接时,先调用 wecomcli-doc-manage 搜索文档,从返回结果中取 docid。
  3. 用户直接提供:用户明确给出了完整 docid,可直接使用,无需再提取或搜索。

© 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

SKILL.md and 5 other files (references) in pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-sheet of Pinvou/pinvou-agent.

  • SKILL.md
  • references/sheet-contents-update.md
  • references/sheet-ranges-get.md
  • references/sheet-rows-append.md
  • references/sheet-subsheets-add.md
  • references/sheet-subsheets-delete.md

Open the folder on GitHubat commit 76cb1db

Compare with similar skills

Wecomcli Sheet 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 Sheet compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wecomcli Sheet this skillPinvou/pinvou-agent2.4k—~1.2kAutomated safety check: PassMIT
WeCom Online Sheet ManagerWecomTeam/wecom-cli3.2k1 repos~985Automated safety check: PassMIT
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Convert Fileduckdb/duckdb-skills5991 repos~720Automated safety check: NotesMIT
Research Integrity Auditxuzhougeng/wisp-science1k—~2.6kAutomated safety check: PassAGPL-3.0
Jmh Benchmark Compareeclipse-rdf4j/rdf4j420—~804Automated safety check: PassBSD-3-Clause

Similar skills

  • WeCom Online Sheet Manager

    WecomTeam/wecom-cli

    Creates, imports, reads and edits WeCom online spreadsheets from the command line, including appending rows and managing sub-sheets.

    3.2k GitHub starsUsed in 1 repo~985 tokens
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Convert File

    duckdb/duckdb-skills

    Official

    Convert any data file to another format: CSV, Parquet, JSON, Excel, GeoJSON, and more.

    599 GitHub starsUsed in 1 repo~720 tokens
    Documents & OfficeAuto-check: notes
  • Research Integrity Audit

    xuzhougeng/wisp-science

    学术审查 / research-integrity screening of a manuscript's figures and reported numbers.

    1k GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Jmh Benchmark Compare

    eclipse-rdf4j/rdf4j

    Parse JMH result text by finding the first header line that starts with Benchmark and contains Mode and Score, build a structured table for all columns/rows, compare overlapping benchmarks across 2+…

    420 GitHub stars~804 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Excel Parser

    Harryoung/efka

    Smart Excel/CSV file parsing with intelligent routing based on file complexity analysis.

    104 GitHub stars~2.3k tokensUpdated 6 mo ago
    Documents & OfficeAuto-check passed

More from Pinvou/pinvou-agent

All 29 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

Questions about Wecomcli Sheet

What does Wecomcli Sheet do?

何时用:仅当用户明确指向企业微信『在线表格』或提供 doc.weixin.qq.com/sheet/ 链接时使用;泛指做表格默认先按消歧确认,智能表格内容操作走 wecomcli-smartsheet,本地表格默认走本地工具。在线表格:新建、导入 CSV/Excel、读取信息与数据、修改内容、追加行、子表管理;文档公共操作走 wecomcli-doc-manage。. Wecomcli Sheet is an agent skill from Pinvou/pinvou-agent.

When should I use Wecomcli Sheet?

Wecomcli Sheet fits situations like: tasks that involve Excel spreadsheets; tasks that involve CSV and tabular files.

How do I install Wecomcli Sheet in Claude Code?

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

How do I install Wecomcli Sheet in Codex?

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

Can I use Wecomcli Sheet 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-sheet -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-sheet, .gemini/skills/wecomcli-sheet, .github/skills/wecomcli-sheet and .opencode/skills/wecomcli-sheet in your project.

What does Wecomcli Sheet need to run?

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

Does Wecomcli Sheet access the network?

SKILL.md names 1 domain. In commands or code: doc.weixin.qq.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Wecomcli Sheet 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 Sheet use?

Wecomcli Sheet 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 Sheet use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Wecomcli Sheet?

Skills that share tags, products or a category with Wecomcli Sheet: WeCom Online Sheet Manager (WecomTeam/wecom-cli, 3.2k stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Convert File (duckdb/duckdb-skills, 599 stars) and Research Integrity Audit (xuzhougeng/wisp-science, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wecomcli Sheet?

Pinvou (a GitHub organization) maintains it in Pinvou/pinvou-agent, which has 2,361 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 7, 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.