Agent skill · data analytics · affaan-m

skill-stocktake

用于审计Claude技能和命令的质量。支持快速扫描(仅变更技能)和全面盘点模式,采用顺序子代理批量评估。

Why this skill is useful

Adds specific scripts for auditing and evaluating Claude skills that the AI wouldn't reliably generate on its own.

What it needs

Requires bash installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.

What this skill does

skill-stocktake 斜杠命令 (/skill-stocktake),用于使用质量检查清单 + AI 整体判断来审核所有 Claude 技能和命令。支持两种模式:用于最近更改技能的快速扫描,以及用于完整审查的全面盘点。 范围 该命令针对以下相对于调用命令所在目录的路径: 路径 描述 ------ ------------- ~/.claude/skills/ 全局技能(所有项目) {cwd}/.claude/skills/ 项目级技能(如果目录存在) 在第 1 阶段开始时,该命令会明确列出找到并扫描了哪些路径。 针对特定项目 要包含项目级技能,请从该项目根目录运行: 如果项目没有 .claude/skills/ 目录,则只评估全局技能和命令。 模式 模式 触发条件 持续时间 ------ --------- --------- 快速扫描 results.json 存在(默认) 5–10 分钟 全面盘点 results.json 不存在,或 /skill-stocktake full 20–30 分钟 结果缓存: ~/.claude/skills/skill-stocktake/results.json 快速扫描流程 仅重新评估自上次运行以来发生更改的技能(5–10 分钟)。 1. 读取 ~/.claude/skills/skill-stocktake/results.json 2. 运行:bash ~/.claude/skills/skill-stocktake/scripts/quick-diff.sh \ ~/.claude/skills/skill-stocktake/results.json (项目目录从 $PWD/.claude/skills 自动检测;仅在需要时显式传递) 3. 如果输出是 []:报告“自上次运行以来无更改。”并停止 4. 使用相同的第 2 阶段标准仅重新评估那些已更改的文件 5. 沿用先前结果中未更改的技能 6. 仅输出差异 7. 运行:bash ~/.claude/skills/skill-stocktake/scripts/save-results.sh \ ~/.claude/skills/skill-stocktake/results.json <<< "$EVALRESULTS" 全面盘点流程 第 1 阶段 — 清单 运行:bash ~/.claude/skills/skill-stocktake/scripts/scan.sh 脚本枚举技能文件,提取 frontmatter,并收集 UTC 修改时间。 项目目录从 $PWD/.claude/skills 自动检测;仅在需要时显式传递。 从脚本输出中呈现扫描摘要和清单表: 技能 7天使用 30天使用 描述 ------- -------- --------- ------------- 第 2 阶段 — 质量评估 启动一个 通用代理 工具子代理,并使用完整的清单和检查项: 子代理读取每项技能,应用检查项,并返回每项技能的 JSON 结果: { "verdict": "Keep" "Improve" "Update" "Retire" "Merge into [X]", "reason": "..." } 分块指导: 每个子代理调用处理约 20 个技能,以保持上下文可管理。在每个块之后将中间结果保存到 results.json (status: "inprogress")。 所有技能评估完成后:设置 status: "completed",进入第 3 阶段。 恢复检测: 如果在启动时找到 status: "inprogress",则从第一个未评估的技能处恢复。 每个技能都根据此检查清单进行评估: 判定标准: 判定 含义 --------- --------- Keep 有用且最新 Improve 值得保留,但需要特定改进 Update 引用的技术已过时(通过 WebSearch 验证) Retire 质量低、陈旧或成本不对称 Merge into \[X] 与另一技能有大量重叠;命名合并目标 评估是整体 AI 判断 — 不是数字评分标准。指导维度: 可操作性:代码示例、命令或步骤,让你可以立即行动 范围契合度:名称、触发器和内容保持一致;不过于宽泛或狭窄 独特性:价值不能被 MEMORY.md / CLAUDE.md / 其他技能取代 时效性:技术引用在当前环境中有效 原因质量要求 — reason 字段必须是自包含且能支持决策的: 不要只写“未更改” — 始终重述核心证据 对于 Retire:说明 (1) 发现了什么具体缺陷,(2) 有什么替代方案覆盖了相同需求 差:"Superseded" 好:"disable-model-i …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills affaan-m/skill-stocktake--eee879

View the source on GitHub

Browse the @skills marketplace