前言¶
在 Agent 里处理 xlsx、docx、pdf 时,常见做法是让用户自己装一堆库、写脚本,或把文件交给在线转换服务。前者步骤多、环境难统一;后者往往要 API Key,且文档会离开本机。若你希望对话里直接完成创建、编辑、转换和简单分析,又坚持数据不出本地、不配置密钥,需要一个把能力写进 Skill、由 Agent 按规范调 Python 的方案。下面介绍 SkillHub 上的「全能本地文档处理专家」。
这是什么¶
「全能本地文档处理专家」是 SkillHub 社区 Skill,坐标为 @user_734b3090/office-toolkit-local,当前版本 1.0.0,分类为 office-efficiency,发布者为 user_734b3090(SkillHub 页面标注作者为李杰)。Skill 标签标明 requires_api_key=false,即不依赖外部 API Key。
一句话定位:在 Agent 中通过自然语言触发,对 xlsx / docx / pdf / pptx / csv / md 等格式进行创建、编辑、转换与分析,执行侧为纯本地 Python。
官方入口:
- SkillHub 页面:https://www.skillhub.cn/skills/user_734b3090/office-toolkit-local
- API 坐标页:https://api.skillhub.cn/user_734b3090/office-toolkit-local
核心功能¶
以下能力均来自 SkillHub 简介与页面描述,未单独展开的实现细节以安装后的 SKILL.md 为准。
| 方向 | 说明 |
|---|---|
| 表格与数据 | Excel(xlsx)公式、图表;csv 处理;数据分析与报告类任务 |
| 文稿 | Word(docx)创建与编辑;中文排版与模板 |
| 合并、拆分、水印、加密等常见操作 | |
| 演示与标记 | PPT(pptx)相关处理;Markdown(md)格式转换 |
| 工程特性 | 批量处理;全程本地、零 API Key |
便于 Agent 匹配的触发词包括:文档、Excel、Word、PDF、PPT、表格、报告、转换、合并、提取、排版、批量,以及 xlsx、docx、pptx、csv、watermark、encrypt、chart、formula、template、office 等。
安装与启用¶
SkillHub 推荐两种方式:用 CLI 安装,或把安装提示词发给当前 AI,让其按官方安装文档操作。
1、安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 安装文档执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文:https://skillhub.cn/install/skillhub.md。
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,Agent 可能无法加载。
skillhub install @user_734b3090/office-toolkit-local --dir <skills 目录>
常用路径(来自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可直接向 Agent 发送 SkillHub 页面给出的提示词,让其根据 https://skillhub.cn/install/skillhub.md 安装 @user_734b3090/office-toolkit-local。
安装完成后,按你所用客户端要求重启或刷新 Agent,使 Skill 生效。
典型用法¶
公开页面未附带独立命令行教程;实际行为由 Skill 包内的 SKILL.md 与附带脚本定义。在启用 Skill 后,可按简介中的场景用自然语言描述任务,并带上上述触发词,例如:
- 说明输入输出路径与格式(如「把目录下多个 pdf 合并为一个文件」)。
- 对 Word,写明是否需要模板或中文排版要求。
- 对 Excel,写明公式、图表或汇总报告需求。
- 对 PDF,写明合并、拆分、水印或加密等具体操作。
Agent 应在本地 Python 环境中执行 Skill 规定的步骤;若缺少依赖,需按 SKILL.md 或安装日志在本地补齐,而非配置云端密钥。
适用场景与注意¶
适合谁
- 需要在 Cursor、Claude Code、Codex 等支持 Skills 的客户端里处理 Office 类文件,且希望文档不经过第三方 API 的开发者或办公自动化用户。
- 需要批量转换、合并、提取或简单分析报告,又不想每次手写 openpyxl、python-docx、PyPDF2 等脚本的场景。
需要注意
- 能力边界以 Skill 简介为准;复杂排版、宏、受保护文档等是否支持,需以安装后的 Skill 文档为准,本文无法核实未公开的细节。
- 纯本地意味着本机需具备相应 Python 依赖与足够磁盘、算力;大批量文件应先小样本试跑。
- SkillHub 抓取信息显示该 Skill 评分 100000、下载 5129 次(统计随平台更新而变化)。
结尾¶
「全能本地文档处理专家」把常见 Office 与 Markdown 操作收敛为一个 office-efficiency 类 Skill,强调本地 Python 与 零 API Key,适合在 Agent 对话里用触发词驱动文档流水线。安装与坐标以 SkillHub 为准:
https://www.skillhub.cn/skills/user_734b3090/office-toolkit-local