Agent skill

Wecomcli Media

by Pinvou in Pinvou/pinvou-agent

何时用:仅当用户明确指向企业微信 mediaid 与本地文件互转时使用;泛指本地文件操作默认走本地工具。基于 mediaid 下载媒体文件到本地,或上传本地文件换取 mediaid 供其他企微技能使用;本技能不解析/识别文件内容,仅负责文件搬运。

MITAuto-check passedDocuments & Office

Install Wecomcli Media

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

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

GitHub CLI
$ gh skill install Pinvou/pinvou-agent wecomcli-media --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-media .claude/skills/wecomcli-media && 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-media
GitHub stars
2.4k
Token cost
~743 tokens
SKILL.md length
186 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

何时用:仅当用户明确指向企业微信 mediaid 与本地文件互转时使用;泛指本地文件操作默认走本地工具。基于 mediaid 下载媒体文件到本地,或上传本地文件换取 mediaid 供其他企微技能使用;本技能不解析/识别文件内容,仅负责文件搬运。

  • Documents & Office work in your project
  • SKILL.md covers 适用范围, 接口详述, 关键约束 and 跨技能依赖
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Wecomcli Media is an agent skill from Pinvou/pinvou-agent. 何时用:仅当用户明确指向企业微信 mediaid 与本地文件互转时使用;泛指本地文件操作默认走本地工具。基于 mediaid 下载媒体文件到本地,或上传本地文件换取 mediaid 供其他企微技能使用;本技能不解析/识别文件内容,仅负责文件搬运。

Its SKILL.md is about 740 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. 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-media”

Requirements

  • Python 3

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

    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 Media loads about 743 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 186 words of instructions outside code blocks.

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

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). 186 words, ~743 tokens.

Download SKILL.mdSave it as .claude/skills/wecomcli-media/SKILL.md (or your agent's skills folder).
name
wecomcli-media
description
何时用:仅当用户明确指向企业微信 media_id 与本地文件互转时使用;泛指本地文件操作默认走本地工具。基于 media_id 下载媒体文件到本地,或上传本地文件换取 media_id 供其他企微技能使用;本技能不解析/识别文件内容,仅负责文件搬运。
version
1.0.0
metadata.cliHelp
wecom-cli media --help

企业微信媒体文件

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

资源型 skill,负责基于 media_id 下载媒体文件到本地,以及把本地文件上传为 media_id。是其他技能(微盘、邮件等)处理 media_id 相关操作的基础依赖:upload 会产出新的 media_id,但本 skill 不负责搜索/发现其他业务场景中已存在的 media_id(如邮件附件、微盘文件的 media_id 由对应业务技能产出),也不解析文件内容。

适用范围

适用
  • 根据其他技能或用户提供的 media_id 下载媒体文件到本地
  • 上传本地文件(本地路径已知)获取 media_id,供其他技能后续使用(如微盘上传素材)
不适用
  • 解析/识别文件内容(正文提取、OCR、看图问答、PDF/Word/Excel 解析等) → 本 skill 只负责把文件下载到本地拿 file_path,如需查看内容请直接通过 file_path 读取该本地文件
  • 搜索/发现其他业务场景中已存在的 media_id(如邮件附件、微盘文件列表/搜索等) → 由对应业务技能负责产出并返回 media_id,本 skill 只接收已有的 media_id 做下载;本地文件转media_id 的场景仍走本 skill 的 upload
  • 编造或猜测 media_id / 本地文件路径 → 两者必须来自其他技能返回或用户明确提供,禁止自行构造

接口详述

下载媒体文件

根据 media_id 下载媒体文件到本地,返回本地文件路径。

命令

bash
wecom-cli media download --json '{"media_id": "MEDIA_ID"}'

入参

字段类型必填说明
media_idstring是文件的 media_id,由上传文件后获得,或由其他技能(邮件附件/内嵌图片等)返回

返回

字段类型说明
file_pathstring下载成功后的本地文件路径

使用规则

  • 下载完成后如需查看文件内容,直接通过 file_path 读取该本地文件。
  • 下载失败时返回错误码和错误信息。
  • media_id 必须是真正的 media_id,不接受任何形式的 URL:若拿到的是一个链接(如 attach_url、正文里的图片/附件链接),不要把这个 URL 当作 media_id 传入本接口,会直接报错。尤其是命中 work.weixin.qq.com/filepreview/security/ 特征的防泄漏加密链接,属于加密的、与用户身份绑定的资源,本接口无法下载或解密,应直接告知用户该文件受防泄漏策略保护,引导其点击链接、在企业微信客户端内打开查看/保存,不要尝试用本接口或其他手段绕过。
上传媒体文件

将本地文件上传,获取 media_id。

命令

bash
wecom-cli media upload --json '{"file_path": "/tmp/example.pdf"}'

入参

字段类型必填说明
file_pathstring是需要上传的文件的本地路径
typestring否媒体类型:image(图片)/voice(语音,源文件仅支持 AMR 格式)/video(视频)/file(文件),可选传入;发送消息时以上传响应返回的 type 为准

返回

字段类型说明
typestring媒体类型:image(图片)/voice(语音)/video(视频)/file(文件)
media_idstring上传后的 media_id,供其他技能后续使用(如微盘upload 的 file_content_media)
created_atstring创建时间,格式:YYYY-MM-DD HH:mm:ss

关键约束

  • media_id / file_path 不得编造:media_id 必须来自上传结果、其他技能返回或用户明确提供;file_path 必须是真实存在的本地路径。两者都没有时用自然语言追问,禁止靠猜测凑一个。
  • 不做内容解析:本 skill 只负责文件的下载落地与上传,download 拿到 file_path 后如需查看内容,直接通过 file_path 读取,不在本 skill 职责范围内。
  • 内部 ID 不外露:media_id 仅用于后续接口调用,禁止直接展示给用户;下载后的本地 file_path 同样不展示给用户。
  • CLI 报错原样转达:命令返回明确错误码时如实告知用户并给替代建议,禁止用 curl / python 等通用手段绕过 CLI 强行完成。

跨技能依赖

依赖场景说明
wecomcli-email邮件附件/内嵌图片的 media_id,使用本 skill 的 download 下载到本地后通过 file_path 读取
wecomcli-disk上传文件到微盘时若已有 media_id,直接作为 disk files upload 的 file_content_media 使用,无需再走本 skill;若只有本地路径且需要先转成 media_id,可用本 skill 的 upload

参数缺失 / 意图不明确时,用自然语言追问让用户明确,不要瞎猜。

© 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-media of Pinvou/pinvou-agent.

Open the folder on GitHubat commit 76cb1db

Compare with similar skills

Wecomcli Media 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 Media compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wecomcli Media this skillPinvou/pinvou-agent2.4k—~743Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k7 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 7 repos~3.5k 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
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • 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
  • 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
  • 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 yesterday
    Documents & OfficeAuto-check passed

More from Pinvou/pinvou-agent

All 28 skills in this repo
  • Tmeet Skill

    Pinvou/pinvou-agent

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

    2.4k GitHub stars~4.8k tokensUpdated yesterday
    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 yesterday
    Auto-check passed
  • Dws

    Pinvou/pinvou-agent

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

    2.4k GitHub stars~5.3k tokensUpdated yesterday
    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 yesterday
    Auto-check passed
  • Lark Base

    Pinvou/pinvou-agent

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

    2.4k GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • Lark Calendar

    Pinvou/pinvou-agent

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

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

Questions about Wecomcli Media

What does Wecomcli Media do?

何时用:仅当用户明确指向企业微信 mediaid 与本地文件互转时使用;泛指本地文件操作默认走本地工具。基于 mediaid 下载媒体文件到本地,或上传本地文件换取 mediaid 供其他企微技能使用;本技能不解析/识别文件内容,仅负责文件搬运。. Wecomcli Media is an agent skill from Pinvou/pinvou-agent.

When should I use Wecomcli Media?

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

How do I install Wecomcli Media in Claude Code?

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

How do I install Wecomcli Media in Codex?

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

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

What does Wecomcli Media need to run?

SKILL.md names no scripts, command-line tools or credentials: Wecomcli Media is instructions for the agent only. Our summary lists: Python 3.

Does Wecomcli Media 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 Media 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 Media use?

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

About 743 tokens (SKILL.md is roughly 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 Media?

Skills that share tags, products or a category with Wecomcli Media: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wecomcli Media?

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