前言¶
在 Cursor、Claude Code 等环境里处理表格时,常见做法是临时写一段 Python 或让模型「口头描述」改表结构。前者交付物往往是脚本而不是 .xlsx;后者又容易漏掉格式、公式或脏数据行。若任务明确要求打开、修改或产出 .xlsx、.csv 等文件,需要一套能约束触发条件与交付形态的 Skill 说明。
下面介绍 SkillHub 社区 Skill「表格使用技能」(坐标 @user_90d58900/excel01),用于在 Agent 侧统一「何时启用、做什么、不做什么」。
这是什么¶
「表格使用技能」是遵循通用 SKILL.md 格式的社区 Skill(来源:community,发布者 user_90d58900,版本 1.0.0,分类 office-efficiency)。它不替代 Excel 本身,而是告诉 Agent:只要电子表格文件是主要输入或主要输出,就应加载该 Skill 并按其中规则执行。
官方页面与 API 入口:
- https://www.skillhub.cn/skills/user_90d58900/excel01
- https://api.skillhub.cn/user_90d58900/excel01
标签标明 requires_api_key=false,安装后无需额外 API Key。SkillHub 页面显示评分 100000,下载 11516 次,安装 228 次(数据以 SkillHub 展示为准)。
核心功能¶
以下能力均来自官方 Skill 简介,概括为可操作范围:
- 读写与修复现有表格:支持
.xlsx、.xlsm、.csv、.tsv。包括增列、计算公式、格式化、制图、清洗杂乱数据等。 - 新建表格:从零创建,或从其他数据源生成电子表格。
- 格式互转:在常见表格文件格式之间转换。
- 脏数据整理:处理错行、表头错位、垃圾数据等,输出为规范电子表格。
- 触发条件:用户提到文件名或路径(例如「下载文件夹里的那个 xlsx」)且要对文件做处理或从数据产出表格时,应触发本 Skill。
明确不触发的情形(交付物不是电子表格文件时不要用本 Skill):
- 主要交付物是 Word、HTML 报告、独立 Python 脚本、数据库流水线,或 Google Sheets API 集成——即使中间涉及表格数据。
安装与启用¶
SkillHub 推荐让 Agent 按官方安装文档操作,或直接对 AI 发送安装提示词。安装说明引用:https://skillhub.cn/install/skillhub.md ,目标坐标为 @user_90d58900/excel01。
1、检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub:
command -v skillhub && skillhub --version
未安装时,可用官方脚本安装(完整包含 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
2、安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录,否则默认落在 ./skills/ 且 Agent 可能无法加载。
skillhub install @user_90d58900/excel01 --dir <你的 skills 目录>
常用路径(来自 SkillHub 安装文档):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目 .windsurf/skills/ |
以 Cursor 为例:
skillhub install @user_90d58900/excel01 --dir ~/.cursor/skills/
也可将下列提示词发给 Agent,由其按 skillhub.md 完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_90d58900/excel01`。
安装后若 Agent 未立即识别新 Skill,按所用客户端说明重启或刷新 skills 配置。
典型用法¶
官方未提供单独示例仓库;用法体现在 触发描述 + 交付物类型 上。下列表述与 Skill 简介一致,便于复现「何时应加载本 Skill」:
- 编辑现有文件:「请打开
report.xlsx,增加一列利润率并按百分比格式显示。」——输入、输出均为电子表格。 - 清洗 CSV:「
data.tsv表头在第 3 行,前面有两行说明文字,请整理成标准表并保存为.xlsx。」——属于 messy tabular data 整理。 - 新建与转换:「根据这份 JSON 列表生成
.xlsx。」或「把export.csv转成.xlsm并保留宏工作簿结构需求时选用.xlsm。」 - 不应触发:「写一份 HTML 数据分析报告」或「写一个 pandas 脚本以后我自己跑」——交付物不是表格文件,应使用其他 Skill 或普通对话,而非本 Skill。
经过上面的步骤安装后,在对话中直接引用文件路径或格式即可,Agent 应依据 Skill 规则选择表格处理流程而非偏离交付形态。
适用场景与注意¶
适合谁
- 日常用 Agent 改表、做表、洗表,且希望最终文件是
.xlsx/.csv等格式的产品、运营、分析岗位。 - 已在 Cursor、Claude Code、Codex 等支持 Skill 的环境工作,并愿意用 SkillHub 管理技能包。
限制与注意
- 本 Skill 约束的是 Agent 行为边界,不保证替代专业 ETL 或在线协作(如 Google Sheets API);后者在官方说明中属于不应触发的范围。
- 大文件、复杂宏(
.xlsm)或极端脏数据仍需人工抽检结果;Skill 未承诺具体库或运行时版本。 - 安装路径错误是常见坑:务必
--dir指向当前 Agent 的 skills 目录。
结尾¶
「表格使用技能」把「表格文件为主输入/输出」这一类任务从泛泛的编码或文档生成里拆开,减少交付物跑偏。若你主要通过 SkillHub 管理 Agent 能力,可从官方页查看说明并安装 @user_90d58900/excel01:
https://www.skillhub.cn/skills/user_90d58900/excel01