前言¶
在 Cursor、Claude Code 等环境里做办公类任务时，常见需求并不是写一段解释性文字，而是直接改好或产出一个 .xlsx、.csv 等文件：补列、写公式、做图表、把乱表头理顺。若只靠通用对话，Agent 容易把结果写成 Markdown 表格或脚本，而不是可交付的表格文件。
SkillHub 上的 PPT撰写（坐标 @user_f32f48f8/avicii-123，当前版本 1.0.1）是一条面向上述场景的社区 Skill，分类为 office-efficiency，标签标明 requires_api_key=false。需要说明的是：页面名称是「PPT撰写」，但官方简介全文描述的是 电子表格（spreadsheet） 的读写与交付，与 PowerPoint 无对应说明；下文能力均以 SkillHub 公布的简介为准。
这是什么¶
PPT撰写 是发布者 user_f32f48f8 在 SkillHub 上架的社区 Skill，采用通用的 SKILL.md 格式，用来约束 Agent：当任务的主输入或主交付物是表格文件时应如何理解与执行。
它要解决的是「表格文件为中心」的任务边界问题：何时该打开/修改现有表格、何时该从零建表或做格式互转，以及何时 不应 误用本 Skill（例如主交付物是 Word、HTML 报告或独立 Python 脚本时）。
核心功能¶
以下均来自 SkillHub 页面简介，未作扩展。
-
打开、读取、编辑或修复现有表格文件
支持.xlsx、.xlsm、.csv、.tsv。典型操作包括：增列、计算公式、格式化、制图、清洗杂乱数据等。 -
新建表格
可从零创建，也可由其他数据源生成表格文件。 -
表格格式互转
在上述几种制表文件格式之间转换。 -
触发与交付约定
- 当用户提到表格文件名或路径（即便很随意，例如「下载文件夹里的那个 xlsx」）且希望对文件做处理或基于文件产出结果时，应触发本 Skill。
- 当需要把畸形行、错位表头、垃圾数据等 整理成规范表格 时，也应触发。
- 交付物必须是表格文件。
- 不要 在以下情况触发：主交付物是 Word 文档、HTML 报告、独立 Python 脚本、数据库流水线或 Google Sheets API 集成——即使任务里涉及表格型数据。
安装与启用¶
本 Skill 不需要 API Key（requires_api_key=false）。安装方式以 SkillHub 官方说明为准。
方式一：让 Agent 按官方文档安装¶
将下面提示发给当前使用的 AI 客户端即可（页面原文）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f32f48f8/avicii-123`。
方式二：使用 SkillHub CLI¶
若本机尚未安装 CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装或仅安装 CLI（文档中的 curl 安装命令）。
安装 Skill 时，必须 使用 --dir 指向当前 Agent 的 skills 目录，否则默认目录可能不会被识别。常用路径示例（摘自同一安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 换成上表对应路径）：
skillhub install @user_f32f48f8/avicii-123 --dir <skills 目录>
SkillHub 页面未单独列出 Cursor / Codex / Claude Code 的差异步骤；差异主要体现在 skills 目录路径 上。安装后若客户端要求重启或重新加载 Skill，按各自产品说明操作即可。
典型用法¶
官方未提供独立示例仓库或脚本清单，用法体现在 触发条件与交付形态 上。可按下面几类需求向 Agent 描述任务（表述需包含「表格文件是主输入或主输出」）：
-
指定路径处理现有文件
例如：打开某路径下的.xlsx，增加列、写入公式或调整格式，并保存为同类型表格文件。 -
清洗与重构
例如：将.csv/.tsv中错行、表头错位或无效行整理为结构规范的表格，输出为.xlsx或.csv。 -
新建或转换
例如：根据给定数据新建.xlsx，或将.xlsx转为.csv/.tsv。
经过上面的步骤，Agent 应在 Skill 约束下把 最终交付物定为表格文件，而不是仅返回文字说明或其它格式为主的结果。
适用场景与注意¶
适合谁
- 经常让 Agent 直接改本地或工作区内的 Excel / CSV 类文件的人。
- 希望减少「Agent 只给方案、不给文件」的情况，并明确 不要 把表格任务做成 Word、HTML 或纯脚本交付的场景。
限制与注意
- 名称与简介不一致：Skill 名为「PPT撰写」，简介内容为 spreadsheet；在 SkillHub 搜索或团队内推荐时，建议以坐标
@user_f32f48f8/avicii-123和简介为准，避免按名称理解为幻灯片制作。 - 非 Google Sheets 在线集成：主交付若是 Google Sheets API 集成，简介明确排除。
- 社区来源：来源为 community，版本 1.0.1；SkillHub 显示评分 100000、下载 917（统计以页面为准，会随时间变化）。
- 安装统计：抓取资料中安装数为 0，仅表示平台侧统计字段，不代表 Skill 不可用；以本地是否成功装入 skills 目录为准。
结尾¶
若你的工作流以 表格文件 为输入或交付物，PPT撰写 用 SKILL.md 把边界写清楚：支持哪些扩展名、何时触发、交付必须是表格、哪些任务应改用其它 Skill。安装时记住坐标 @user_f32f48f8/avicii-123，并把文件装到当前 Agent 的 skills 目录。
