Catalog 与示例
最后校验：2026-05-30
写 Skill 前，先看现成范例。好的 Catalog 能帮你判断：哪些内容适合放进 SKILL.md，哪些应该拆到 scripts/、references/ 或 assets/。
官方仓库
| 仓库 | 定位 |
|---|---|
| anthropics/skills | Anthropic 官方示例库，包含文档处理、设计、测试、MCP 生成等示例 |
| openai/skills | OpenAI Codex 官方示例与系统级 skill-creator |
| agentskills/agentskills | 开放规范源码、参考实现与校验工具 |
推荐优先读官方仓库，因为它们最接近平台真实行为。
社区聚合
| 仓库 | 适合看什么 |
|---|---|
awesome-claude-skills | Claude 生态的常见使用场景 |
awesome-codex-skills | Codex 技能安装与工程类 Skill |
awesome-agent-skills | 跨平台目录结构和兼容实践 |
skills-best-practices | 专业级写作规范与反模式 |
社区仓库适合找灵感，但安装前仍要审计。
实战精品类型
文档处理类
典型能力：
- PDF 文本与表格提取
- DOCX 生成与编辑
- PPTX 生成
- XLSX 分析与格式化
学习重点：
- 如何把确定性转换放进脚本
- 如何处理复杂文件格式边界
- 如何使用模板和 assets
工程工作流类
典型能力：
- code review
- TDD
- PRD 生成
- release notes
- 安全审计
- 项目脚手架
学习重点：
- 如何写 SOP
- 如何写输出格式
- 如何设置 should-not-trigger 边界
- 如何和项目 Rule 配合
设计与写作类
典型能力：
- frontend design
- brand guideline
- marketing copy
- slide deck
- report writing
学习重点：
- 如何用示例约束审美和语气
- 如何把长模板放进
assets/ - 如何把风格规则和执行步骤分开
安全与合规类
典型能力：
- 漏洞审查
- dependency audit
- policy check
- 敏感信息扫描
学习重点：
- 如何设置高风险操作确认
- 如何声明不做什么
- 如何避免过宽工具权限
中文社区
中文读者可以关注：
- CNB Skills 仓库
- 国内 IDE / Agent 平台的技能目录
- 团队内部沉淀的项目级 Skills
中文 Skill 的重点不是翻译英文示例，而是沉淀本地团队真实流程：
- 发布流程
- 代码审查标准
- 安全红线
- 工单格式
- 内部 API 使用约定
- 文档模板
看 Catalog 时怎么学
不要只看“这个 Skill 做什么”，要拆解它的结构：
description怎么触发？- 正文是否有明确 SOP？
- 是否有 examples？
- 是否使用 scripts？
- 是否把长资料放进 references？
- 是否把模板放进 assets？
- 是否声明依赖？
- 是否有安全边界？
- 是否有 eval 或测试样例？
安装前最低审查
从 Catalog 安装任何第三方 Skill 前：
- [ ] 阅读
SKILL.md - [ ] 检查
scripts/ - [ ] 检查外部 URL
- [ ] 检查依赖安装命令
- [ ] 检查工具权限
- [ ] 在临时目录试跑
更多安全细节见 安全与信任模型。