Agent skill

Wecomcli Doc

by Pinvou in Pinvou/pinvou-agent

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

MITAuto-check passedDocuments & Office

Install Wecomcli Doc

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

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

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

At a glance

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

  • Works in 2 steps: 生成 .docx 文件:按 +doc-create 生成 .docx 文件。 → 导入为企微doc文档:使用下方「导入doc文档」接口将生成的 .docx…
  • Tasks that involve Word documents
  • SKILL.md covers 适用范围, 接口路由表, 接口详述 and 跨技能依赖, plus 1 more section
  • Runs Python scripts from its folder; reaches doc.weixin.qq.com and page.weixin.qq.com

What it does

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

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/doc-contents-append.md`, `references/doc-contents-overwrite.md` and `references/doc-create.md`).

It sits in Documents & Office, covering Word documents. It works with Microsoft Word 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 Word documents

Example prompts

  • “/wecomcli-doc”

Requirements

  • Python 3

Workflow steps

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

  1. 生成 .docx 文件:按 +doc-create 生成 .docx 文件。
  2. 导入为企微doc文档:使用下方「导入doc文档」接口将生成的 .docx 文件导入为企微doc文档。注意import导入的时候 file_name 应和文档标题保持一致。

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    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
    • page.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 Doc loads about 1.1k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 274 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Pinvou/pinvou-agent at commit 76cb1db, republished under its MIT licence (© Pinvou). 274 words, ~1,120 tokens.

Download SKILL.mdSave it as .claude/skills/wecomcli-doc/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
wecomcli-doc
description
何时用:仅当用户明确指定 doc/docx/word/在线文档/office文档或提供 doc.weixin.qq.com/doc/ 链接时使用;泛指「做个文档/写文档/整理成文档」默认走 wecomcli-smartpage 或本地工具,本技能不得抢占。doc 内容操作:新建、导入(.doc/.docx/.txt)、读取、追加、覆盖写入;结构化数据需求改用智能文档/智能表格;公共管理走 wecomcli-doc-manage。

企业微信doc文档管理

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

资源型 skill,负责doc文档(doc)的新建、导入与内容读写。

适用范围

适用
  • 新建 / 导入企微 doc 文档
  • 读取 doc 文档内容
  • 向 doc 文档追加一行 / 覆盖写入doc 文档
不适用
  • 搜索文档 / 修改文档权限 / 重命名 / 加成员 → 改用 wecomcli-doc-manage
  • 在线表格操作 → 改用 wecomcli-sheet
  • 智能表格操作 → 改用 wecomcli-smartsheet
  • 含字段 / 记录 / 筛选 / 排序 / 统计 / 分组等结构化数据语义 → 改用 wecomcli-smartsheet 或 wecomcli-smartpage(禁止用 doc + markdown 静态表格变通)
易混淆场景路由
  • 用户说"创建文档 / 写文档 / 整理成文档" 且未指定 doc 类型 → 改用 wecomcli-smartpage(智能文档为默认)
  • 用户给的链接是 https://doc.weixin.qq.com/smartpage/... 或者 https://page.weixin.qq.com/smartpage/... → 改用 wecomcli-smartpage
  • 若遇到的 docid 以 a1 或者 b1 开头(形如 a1_xxxx, b1_xxxx)→ 改用 wecomcli-smartpage

接口路由表

路由表第二列若是 references/xxx.md 链接 → 必须先用 read 读完该文件,再构造命令。

用户意图参考位置
新建doc文档(在线)见下方「新建doc文档」
导入本地文件为企微doc文档见下方「导入doc文档」
读取doc文档内容见下方「读取doc文档内容」
追加文本到doc文档末尾+contents-append
全量覆盖doc文档内容+contents-overwrite
写入语义裁定(追加 vs 覆盖)
  • 默认追加:用户用「写入 / 写到 / 记录 / 补充 / 加进去 / 记一下」等中性动词,且未明确要求清空或替换时,一律走 append(追加,不破坏原有内容)。
  • 仅显式覆盖:仅当用户明确出现「覆盖 / 重写 / 替换 / 清空重写 / 整个换成」等强语义词时,才走 overwrite。

接口详述

新建doc文档

新建企微doc文档统一走「生成 .docx → 导入」两步流程:

  1. 生成 .docx 文件:按 +doc-create 生成 .docx 文件。
  2. 导入为企微doc文档:使用下方「导入doc文档」接口将生成的 .docx 文件导入为企微doc文档。注意import导入的时候 file_name 应和文档标题保持一致。
导入doc文档

把本地文件(.doc / .docx / .txt)导入为企微doc文档。

命令

bash
wecom-cli doc import --json '<JSON 参数>'

参数

字段类型必填默认值语义
doc_typestring是doc固定为 doc(doc文档)
file_namestring是—二进制文件名(含后缀),用于业务判断源文件类型
file_pathstring是—源文件的本地绝对路径
passwdstring否—Office 文件加密密码(若有)

返回

字段类型说明
docidstring导入完成后的文档 ID
urlstring导入完成后的访问链接
task_statusstring任务状态枚举,如 succ 成功
读取doc文档内容

读取doc文档的文档内容。

命令

bash
wecom-cli doc contents get --json '<JSON 参数>'

参数

字段类型必填默认值语义
docidstring是—doc文档 ID
content_typestring否markdown返回内容格式枚举:text / markdown / ooxml;

返回

字段类型说明
urlstring文档访问链接
namestring文档名称
contentstring文档内容较短时直接返回的原文
file_pathstring文档内容较长时自动落盘的本地文件路径;需用 read 读取路径内文本后再展示
documentobjectcontent_type=ooxml 时返回的文档对象
versionint文档版本号

跨技能依赖

依赖技能何时触发使用被依赖 skill 做什么
wecomcli-doc-manage用户只给文档名称/关键词,需先拿 docid 再读写内容使用 wecomcli-doc-manage skill 搜索文档拿 docid
wecomcli-smartpage读取doc文档内容后,用户要求"做成智能文档/排版成 smartpage"使用 wecomcli-smartpage skill 生成智能文档

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

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 4 other files (scripts, references) in pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-doc of Pinvou/pinvou-agent.

  • SKILL.md
  • references/doc-contents-append.md
  • references/doc-contents-overwrite.md
  • references/doc-create.md
  • scripts/build_docx.py

Open the folder on GitHubat commit 76cb1db

Compare with similar skills

Wecomcli Doc 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 Doc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wecomcli Doc this skillPinvou/pinvou-agent2.4k—~1.1kAutomated safety check: PassMIT
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Wechat Skill843645440/wechat-skill107—~1.3kAutomated safety check: PassAGPL-3.0
WeCom Online Doc ManagerWecomTeam/wecom-cli3.2k1 repos~1.2kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary

Similar skills

  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Wechat Skill

    843645440/wechat-skill

    微信公众号文章排版与多账号发布工具,把已有 Markdown、DOCX、PDF 或纯文本转成可直接粘贴或通过官方 API 写入草稿箱/发布的 HTML。用于用户明确要求“公众号排版”“微信排版”“转公众号 HTML”“自动排版”“一键排版”、上传草稿、发布已有文章或配置多账号发布时。单独要求撰写文章时使用…

    107 GitHub stars~1.3k tokensUpdated 23 days ago
    Documents & OfficeAuto-check passed
  • WeCom Online Doc Manager

    WecomTeam/wecom-cli

    Creates WeCom online docs, imports local .doc, .docx or .txt files as docs, reads their content and appends to or overwrites them through wecom-cli.

    3.2k GitHub starsUsed in 1 repo~1.2k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days 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
  • 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
  • Lark Calendar

    Pinvou/pinvou-agent

    【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书日历:管理日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。不负责:查询视频会议记录(本 skill 只覆盖日程;lark-vc 技能未随包收录,可 CLI 直连,见意图路由)、待办任务(走 lark-task)。

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

Questions about Wecomcli Doc

What does Wecomcli Doc do?

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

When should I use Wecomcli Doc?

Wecomcli Doc fits situations like: tasks that involve Word documents.

How do I install Wecomcli Doc in Claude Code?

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

How do I install Wecomcli Doc in Codex?

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

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

What does Wecomcli Doc need to run?

Going by SKILL.md and its folder, Wecomcli Doc needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Wecomcli Doc access the network?

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

Is Wecomcli Doc 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Wecomcli Doc use?

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

About 1.1k tokens (SKILL.md is roughly 4.5k 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 2.4k tokens, read only when the agent opens those files.

What are the alternatives to Wecomcli Doc?

Skills that share tags, products or a category with Wecomcli Doc: Gzh Design (isjiamu/gzh-design-skill, 3.9k stars), Wechat Skill (843645440/wechat-skill, 107 stars), WeCom Online Doc Manager (WecomTeam/wecom-cli, 3.2k stars) and Markitdown (ImCa0/just-laws, 781 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wecomcli Doc?

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.