前言¶

在 Agent 对话里丢一条链接、一份 PDF 或一段音视频，常见做法是让模型「直接读」或自己写脚本抓正文。网页反爬、PDF 分页、YouTube 元数据与转写，每一步都要单独处理，还容易占满上下文。下面介绍 SkillHub 上的社区 Skill Summarize-1.0（坐标 @user_dd0cd521/cn20260415，当前版本 1.0.1）：它把 summarize 命令行工具写进 Agent 的工作流，用同一套 CLI 处理网页、本地 PDF/图片/音频和 YouTube 链接，再交给模型做结构化摘要。

这是什么¶

Summarize-1.0 属于 SkillHub 分类 knowledge-management，来源为 community，由发布者 user_dd0cd521 维护。Skill 的 SKILL.md 中 name 为 summarize，一句话定位是：通过 summarize CLI 对 URL 或本地文件生成摘要，覆盖 web、PDF、图片、音频、YouTube。

与「在提示词里粘贴全文」相比，这个 Skill 要求环境里已安装可执行文件 summarize，并按文档配置各模型厂商的 API Key；Agent 按 Skill 说明调用 CLI，而不是临时拼凑抓取逻辑。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与 SkillHub 页面简介，已核对一致。

1. 多输入类型：HTTP(S) 网页、本地路径（含 PDF 等文件）、YouTube 链接（支持 --youtube auto）。
2. 模型与长度：通过 --model 指定提供商模型；可用 --length short|medium|long|xl|xxl|<chars>、--max-output-tokens 控制输出规模；未指定模型时默认 google/gemini-3-flash-preview。
3. 提取与输出模式：--extract-only（仅 URL）、--json（机器可读输出）；网页抓取可走 --firecrawl auto|off|always；YouTube 在配置 APIFY_API_TOKEN 时可走 Apify 回退。
4. 可选配置：用户级配置文件 ~/.summarize/config.json 可设置默认 model 等项。
5. 依赖声明：Skill 元数据标明需要本机存在 summarize 二进制；并给出 Homebrew 安装路径 steipete/tap/summarize（brew 方式，适用于 macOS 等具备 brew 的环境）。

SkillHub 标签 requires_api_key=true：至少要为所选模型提供商配置对应环境变量（见下一节）。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 安装文档 检查或安装：

command -v skillhub && skillhub --version

未安装时可执行（完整安装，含默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 将 Summarize-1.0 装到当前 Agent 的 skills 目录¶

SkillHub 要求安装时使用 --dir，否则默认落在 ./skills/ 且 Agent 可能无法加载。坐标与页面提示一致：

skillhub install cn20260415 --namespace user_dd0cd521 --dir <你的 Agent skills 目录>

常见路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

也可将下面提示交给支持 Skill 的 AI，让其按 https://skillhub.cn/install/skillhub.md 安装 @user_dd0cd521/cn20260415（SkillHub 技能页提供的官方话术）。

3. 安装 summarize CLI¶

Skill 运行前需本机有 summarize。SKILL.md 推荐的 brew 方式为：

brew install steipete/tap/summarize

Linux 等无 brew 的环境需自行从 summarize.sh 获取与平台匹配的安装方式；Skill 包内仅列出上述 brew 配方，未提供其他平台的官方命令，此处不臆造。

4. API Key 与可选服务¶

按所选 --model 设置密钥（摘自 SKILL.md）：

• OpenAI：OPENAI_API_KEY
• Anthropic：ANTHROPIC_API_KEY
• xAI：XAI_API_KEY
• Google：GEMINI_API_KEY（别名：GOOGLE_GENERATIVE_AI_API_KEY、GOOGLE_API_KEY）

可选：

• FIRECRAWL_API_KEY：站点抓取受阻时配合 --firecrawl
• APIFY_API_TOKEN：YouTube --youtube auto 时的 Apify 回退

安装 Skill 后，按各 Agent 说明刷新或重启，使 SKILL.md 被加载。

典型用法¶

下列示例直接来自 Skill 包内 Quick start 与配置说明，可在终端复现（需已安装 summarize 并配置密钥）。

摘要网页：

summarize "https://example.com" --model google/gemini-3-flash-preview

摘要本地 PDF：

summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview

摘要 YouTube（自动策略）：

summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto

设置默认模型（可选）：

# 编辑 ~/.summarize/config.json

{ "model": "openai/gpt-5.2" }

在 Agent 会话中，启用本 Skill 后，用自然语言说明要摘要的 URL 或文件路径即可；Agent 应按 SKILL.md 调用上述 CLI 并把结果纳入回复。具体对话措辞因 Agent 而异，Skill 未规定固定提示词模板。

适用场景与注意¶

适合谁

• 经常让 Coding Agent 读文档、读论文 PDF、听会议纪要音频，又希望减少手写爬虫的场景。
• 已在用或愿意引入 summarize CLI，并接受按调用向模型厂商付费（API Key）的团队。

限制与注意

1. 硬依赖：无 summarize 二进制时 Skill 元数据中的 requires.bins 无法满足，应先装 CLI 再谈 Skill。
2. 密钥与合规：requires_api_key=true；密钥只应通过环境变量或本机配置注入，不要写进仓库。
3. 平台差异：brew 安装说明面向 Homebrew 用户；其他系统请自行核对 summarize 官方安装方式。
4. 社区 Skill：来源为 community，版本 1.0.1；升级可用 skillhub 对同一 slug 重新 install（必要时加 --force），以 SkillHub 页面为准。
5. SkillHub 侧数据（抓取时）：评分 100000，下载 775，安装 8；分类 knowledge-management。与页面简介一致的核心描述为：Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).

结尾¶

Summarize-1.0 的价值在于把「多类型输入 → 统一 CLI 摘要」固化成 Agent Skill，减少每次临时写抓取脚本的成本。若你使用 Cursor 等支持 SkillHub 的客户端，可按本文装好 @user_dd0cd521/cn20260415、本机 summarize 与 API Key，再把链接或文件路径交给 Agent 处理。

• SkillHub 页面：https://www.skillhub.cn/skills/user_dd0cd521/cn20260415
• API 坐标入口：https://api.skillhub.cn/user_dd0cd521/cn20260415
• summarize 项目主页：https://summarize.sh