表格使用技能:以电子表格为输入输出的 Agent Skill

前言

在 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 简介,概括为可操作范围:

  1. 读写与修复现有表格:支持 .xlsx、.xlsm、.csv、.tsv。包括增列、计算公式、格式化、制图、清洗杂乱数据等。
  2. 新建表格:从零创建,或从其他数据源生成电子表格。
  3. 格式互转:在常见表格文件格式之间转换。
  4. 脏数据整理:处理错行、表头错位、垃圾数据等,输出为规范电子表格。
  5. 触发条件:用户提到文件名或路径(例如「下载文件夹里的那个 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」:

  1. 编辑现有文件:「请打开 report.xlsx,增加一列利润率并按百分比格式显示。」——输入、输出均为电子表格。
  2. 清洗 CSV:「data.tsv 表头在第 3 行,前面有两行说明文字,请整理成标准表并保存为 .xlsx。」——属于 messy tabular data 整理。
  3. 新建与转换:「根据这份 JSON 列表生成 .xlsx。」或「把 export.csv 转成 .xlsm 并保留宏工作簿结构需求时选用 .xlsm。」
  4. 不应触发:「写一份 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye