前言¶

调研资料、复盘会议、跟进技术视频时，输入往往是链接、PDF、录音或 YouTube，而不是一段可直接粘贴的正文。若只靠模型「凭印象概括」，容易漏掉细节，也难以核对来源。更稳妥的做法是先把内容抽取或转写，再生成摘要。

下面介绍的 summary 是 SkillHub 上的社区 Skill（坐标 @user_b7e5c773/skill，当前版本 1.0.0）。它把 Agent 的工作流对齐到 summarize 命令行工具：由 CLI 负责网页、PDF、图片、音频、YouTube 等输入的提取与摘要，Agent 按 Skill 约定调用命令并处理输出，而不是手写一套临时脚本。

这是什么¶

summary 属于 SkillHub 分类 knowledge-management（子类「摘要总结」），发布者为 user_b7e5c773，来源标注为 community。

官方简介（与页面一致）：

Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).

Skill 标签 requires_api_key=true：实际跑摘要或部分媒体能力时，通常需要为 summarize 或其调用的模型、转写服务配置 API Key；Skill 侧要求 Agent 通过 summarize status 等方式检查就绪情况，且不要打印或泄露密钥值。

核心功能¶

依据 SkillHub 公示的简介与 summarize 项目文档，该 Skill 覆盖的能力可归纳为：

1. 网页与远程文档：对 http/https 链接做可读性提取并生成摘要。
2. 本地或远程 PDF：路径或 URL 形式的 PDF 输入。
3. 图片：本地图片文件参与提取与摘要流程。
4. 音频：本地录音等文件，可走转写再摘要。
5. YouTube：视频链接，优先字幕/转写路径，再进入摘要。
6. 仅提取不摘要：通过 --extract 等选项拿到清洗后的 Markdown 或文本，供后续人工或 Agent 处理。

Skill 页面 overviewMd 为空，未提供额外长文说明；能力边界以简介中的媒体类型与 summarize CLI 行为为准。

安装与启用¶

在 SkillHub 安装 Skill¶

SkillHub 详情页给出的安装说明是：先阅读安装指南，再安装指定坐标。

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_b7e5c773/skill。

若已安装 skillhub CLI，可按指南将 Skill 装进当前 Agent 的 skills 目录（须使用 --dir，否则默认目录可能不被 Agent 加载）。示例：

command -v skillhub && skillhub --version
skillhub install @user_b7e5c773/skill --dir ~/.cursor/skills/

Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。具体以你使用的客户端为准，详见 SkillHub 安装文档。

也可在 SkillHub 页面下载 skill-1.0.0 Zip 包，解压到对应 skills 目录后重启或刷新 Agent。

安装 summarize CLI（运行依赖）¶

Skill 描述的是「用 summarize CLI」完成任务，因此本机需要可执行的 summarize 命令。官方安装文档要求 Node 24+，跨平台可用 npm：

npm i -g @steipete/summarize

macOS / Linux 也可选 Homebrew：

brew install summarize

安装后自检：

summarize --version
summarize status

纯网页摘要可不装额外系统工具；YouTube 幻灯片、部分下载转写路径等可能依赖 ffmpeg、yt-dlp、tesseract 等可选组件，缺什么以命令报错为准再补装。

API Key 与配置¶

SkillHub 标记 requires_api_key=true。summarize 在需要 LLM 摘要或云转写时，会读取环境变量或 ~/.summarize/config.json（优先级：CLI 参数 > 环境变量 > 配置文件 > 默认）。常见变量包括 OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEY 等；媒体转写还可配置 GROQ_API_KEY 等。配置方式见 summarize 安装与 Provider 说明。

典型用法¶

启用 summary 后，Agent 应把 summarize 当作唯一推荐入口：先 summarize --help / summarize status 确认环境，再按任务选最窄命令。下列示例与 Skill 简介中的输入类型一致，可在终端直接复现（需已安装 CLI 并完成 Key 配置）。

网页或远程 PDF：

summarize "https://example.com/article"
summarize "https://example.com/report.pdf" --length short

本地 PDF、音频：

summarize "./report.pdf"
summarize "./recording.m4a"

YouTube：

summarize "https://youtu.be/VIDEO_ID"

只提取正文、不调用摘要模型：

summarize "https://example.com/article" --extract --format md
summarize "./report.pdf" --extract --format md

给自动化或下游 Agent 解析的 JSON 输出：

summarize "https://example.com" --json --metrics off > result.json

远程页面或媒体较慢时，可为单次任务加超时，例如 --timeout 2m。涉及机密材料时，应先确认允许的模型与转写提供方，再执行命令。

适用场景与注意¶

适合谁

• 经常把「一个 URL / 一份 PDF / 一段录音 / 一个视频」交给 Agent 做结构化摘要或摘录的开发者。
• 希望 Agent 行为稳定、可审计：命令、退出码、stdout/stderr 分离清晰，便于脚本化。

限制与注意

• Skill 依赖本机 summarize 与网络/Key；无 Key 时部分路径只能 --extract 或会失败，需用 summarize status 排查。
• YouTube、幻灯片、说话人分离等高级能力可能额外依赖 yt-dlp、云转写 Key 或本地 whisper.cpp，与「仅摘要普通网页」的依赖不同。
• SkillHub 统计（截至页面展示）：约 5786 次下载；安装后若行为异常，应核对 Zip 包内容与坐标是否为 @user_b7e5c773/skill v1.0.0。

结尾¶

summary 的价值在于：把「多形态输入 → 提取/转写 → 摘要」收敛到一条 CLI 与一套 Agent 约定，减少每次临时写爬虫或转写脚本的成本。官方 Skill 页与 API 入口：

• SkillHub：https://www.skillhub.cn/skills/user_b7e5c773/skill
• https://api.skillhub.cn/user_b7e5c773/skill

summarize CLI 安装与命令细节：https://summarize.sh/docs/install.html