前言¶
自己写 Agent Skill 时，常见问题不是「能不能跑」，而是结构是否利于渐进式加载、description 是否能让模型正确触发、工作流有没有确认节点、references 是否臃肿。这些问题靠人工通读 SKILL.md 很难一致把关，也缺少可复用的分级标准。
下面介绍 SkillHub 社区 Skill skill 审查与创建（坐标 @user_11f3afce/skill-review-main，版本 1.0.0）：对 Claude / Cursor 等环境的 Skill 做规范审查并输出分级报告，也可生成符合规范的 Skill 骨架。标签标明 requires_api_key=false，不依赖额外 API Key。
这是什么¶
skill 审查与创建 由社区发布者 user_11f3afce 维护，分类为 dev-programming，在 SkillHub 上评分 100000，下载 1252 次（截至页面展示数据）。
一句话定位：面向 SKILL.md 体系 的质量审查与脚手架工具——既能在对话中按 rubric 审查现有 Skill，也能通过 --template 生成规范骨架。
核心功能¶
官方简介中列出的审查维度包括（均为已公开描述，非推断）：
- 渐进式加载（progressive disclosure）：内容是否分层、避免一次性塞满上下文。
- description 与触发：frontmatter / description 是否包含可检索的关键词与使用场景。
- 工作流 checklist：步骤是否可执行、可核对。
- 确认节点：关键操作前是否要求用户确认。
- 脚本封装：重复逻辑是否下沉到 scripts，而非全写在正文。
- 参数系统：输入输出、配置项是否清晰。
- references 组织：引用材料是否分文件、按需加载。
- Pre-Delivery：交付前检查项是否完备。
- CLI + Skill 模式：是否区分命令行与 Skill 协作边界。
- 反 Slop（anti-slop）：规避空泛、不可执行的「废话 Skill」。
审查结果按 P0–P3 分级输出报告，便于先修阻断项再优化体验。
除审查外，Skill 支持 --template：生成符合上述规范导向的 Skill 目录与文件骨架，适合从零起草或重构旧 Skill。
触发方式（摘自官方 description，中英文均可）：例如 review this skill、audit my skill、lint SKILL.md、check skill quality、skill scaffold、skill template、帮我检查 skill、审查 skill、看看这个 skill 写得怎么样、生成 skill 模板、这个 skill 是不是 slop 等。相关英文关键词还包括 review skill、audit skill、skill rubric、progressive disclosure、slop、anti-slop 等。
安装与启用¶
SkillHub 页面给出的安装指引是：让 Agent 参照 SkillHub 安装文档，安装坐标 @user_11f3afce/skill-review-main。
若本机已有 skillhub CLI，可按官方文档将 Skill 装到当前 Agent 实际使用的 skills 目录（装错目录会导致 Agent 识别不到）。文档强调安装时必须使用 --dir，示例流程如下。
1、检查 CLI 是否已安装：
command -v skillhub && skillhub --version
2、未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
3、安装本 Skill（将 --dir 换成你当前环境的 skills 路径）：
skillhub install user_11f3afce/skill-review-main --dir <你的 skills 目录>
常用路径参考（来自 SkillHub 安装文档，按你实际使用的客户端选择）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后若 Agent 未立即加载新 Skill，需按你所用客户端的说明刷新或重启后再试。各客户端对 Skill 的发现规则不同，以官方文档为准。
典型用法¶
审查已有 Skill¶
在已启用该 Skill 的对话中，指向待审查目录或粘贴 SKILL.md 路径，用自然语言发起审查即可。例如：
- 「帮我审查 skill，路径是
~/.cursor/skills/my-tool/SKILL.md」 - 「audit my skill，看看 progressive disclosure 和 anti-slop 有没有问题」
- 「lint SKILL.md，按 P0–P3 给报告」
Agent 会按 Skill 内嵌的 rubric 对照上述维度，输出分级报告；你根据 P0/P1 项优先修改，再迭代复审。
生成规范骨架¶
官方简介明确支持 --template 生成骨架。可在对话中说明需求，例如：
- 「用 skill template 生成一个处理 PDF 的 Skill 骨架」
- 「skill scaffold，要包含 references 和 scripts 目录结构」
具体生成物以 Skill 包内脚本与说明为准；若需核对行为，可在安装后查看该 Skill 目录下的 SKILL.md 与附带资源。
适用场景与注意¶
适合谁
- 维护多个 Agent Skill 的团队，需要统一质量门槛与审查话术。
- 刚接触 SKILL.md 格式，希望对照 checklist 避免「能触发但不可维护」的写法。
- 怀疑现有 Skill 属于 slop（堆砌说明、缺少可执行步骤），需要结构化诊断。
注意
- 本 Skill 为 社区来源（
community），审查结论依赖其内置 rubric，不等同于 Cursor / Anthropic 官方认证。 - 公开资料未单独列出各客户端的差异配置；审查与脚手架均在 Agent 对话上下文中完成，
--template的具体参数以 Skill 包内文档为准。 - SkillHub 页面统计的下载量为 1252，与第三方转载数据可能不一致，以 SkillHub 技能页 为准。
结尾¶
skill 审查与创建 把「写得像 Skill」和「写得可用、可维护」拆开：用 P0–P3 报告做审查，用 --template 做起点。若你正在打磨 Claude / Cursor Agent Skill，可从 SkillHub 安装 @user_11f3afce/skill-review-main，官方入口：https://www.skillhub.cn/skills/user_11f3afce/skill-review-main。
