Agent skill

Skill Stocktake

by affaan-m in affaan-m/ECC

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

MITAuto-check passedAgent Workflows

Install Skill Stocktake

skills CLI
$ npx skills add affaan-m/ECC --skill skill-stocktake -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC skill-stocktake --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/zh-CN/skills/skill-stocktake .claude/skills/skill-stocktake && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-stocktake
GitHub stars
277k
Used in
3 other repos
Token cost
~1.2k tokens
SKILL.md length
303 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 7 steps: 读取… → 运行:bash… → 如果输出是 []:报告“自上次运行以来无更改。”并停止 → …
  • Tasks that involve Skill management
  • SKILL.md covers 范围, 模式, 快速扫描流程 and 全面盘点流程, plus 2 more sections
  • Calls bash

What it does

Skill Stocktake is an agent skill from affaan-m/ECC. 用于审计Claude技能和命令的质量。支持快速扫描(仅变更技能)和全面盘点模式,采用顺序子代理批量评估。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Skill management. It works with Bash. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Tasks that involve Skill management

Example prompts

  • “/skill-stocktake”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 读取 ~/.claude/skills/skill-stocktake/results.json
  2. 运行:bash ~/.claude/skills/skill-stocktake/scripts/quick-diff.sh \ ~/.claude/skills/skill-stocktake/results.json
  3. 如果输出是 []:报告“自上次运行以来无更改。”并停止
  4. 使用相同的第 2 阶段标准仅重新评估那些已更改的文件
  5. 沿用先前结果中未更改的技能
  6. 仅输出差异
  7. 运行:bash ~/.claude/skills/skill-stocktake/scripts/save-results.sh \ ~/.claude/skills/skill-stocktake/results.json <<< "$EVAL_RESULTS"

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Stocktake loads about 1.2k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 303 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 303 words, ~1,199 tokens.

Download SKILL.mdSave it as .claude/skills/skill-stocktake/SKILL.md (or your agent's skills folder).
name
skill-stocktake
description
用于审计Claude技能和命令的质量。支持快速扫描(仅变更技能)和全面盘点模式,采用顺序子代理批量评估。
origin
ECC

skill-stocktake

斜杠命令 (/skill-stocktake),用于使用质量检查清单 + AI 整体判断来审核所有 Claude 技能和命令。支持两种模式:用于最近更改技能的快速扫描,以及用于完整审查的全面盘点。

范围

该命令针对以下相对于调用命令所在目录的路径:

路径描述
~/.claude/skills/全局技能(所有项目)
{cwd}/.claude/skills/项目级技能(如果目录存在)

在第 1 阶段开始时,该命令会明确列出找到并扫描了哪些路径。

针对特定项目

要包含项目级技能,请从该项目根目录运行:

bash
cd ~/path/to/my-project
/skill-stocktake

如果项目没有 .claude/skills/ 目录,则只评估全局技能和命令。

模式

模式触发条件持续时间
快速扫描results.json 存在(默认)5–10 分钟
全面盘点results.json 不存在,或 /skill-stocktake full20–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 <<< "$EVAL_RESULTS"

全面盘点流程

第 1 阶段 — 清单

运行:bash ~/.claude/skills/skill-stocktake/scripts/scan.sh

脚本枚举技能文件,提取 frontmatter,并收集 UTC 修改时间。 项目目录从 $PWD/.claude/skills 自动检测;仅在需要时显式传递。 从脚本输出中呈现扫描摘要和清单表:

扫描中:
  ✓ ~/.claude/skills/         (17 个文件)
  ✗ {cwd}/.claude/skills/    (未找到 — 仅限全局技能)
技能7天使用30天使用描述
第 2 阶段 — 质量评估

启动一个 通用代理 工具子代理,并使用完整的清单和检查项:

text
Agent(
  subagent_type="general-purpose",
  prompt="
根据检查清单评估以下技能清单。

[INVENTORY]

[CHECKLIST]

为每项技能返回 JSON:
{ \"verdict\": \"Keep\"|\"Improve\"|\"Update\"|\"Retire\"|\"Merge into [X]\", \"reason\": \"...\" }
"
)

子代理读取每项技能,应用检查项,并返回每项技能的 JSON 结果:

{ "verdict": "Keep"|"Improve"|"Update"|"Retire"|"Merge into [X]", "reason": "..." }

分块指导: 每个子代理调用处理约 20 个技能,以保持上下文可管理。在每个块之后将中间结果保存到 results.json (status: "in_progress")。

所有技能评估完成后:设置 status: "completed",进入第 3 阶段。

恢复检测: 如果在启动时找到 status: "in_progress",则从第一个未评估的技能处恢复。

每个技能都根据此检查清单进行评估:

- [ ] 已检查与其他技能的内容重叠情况
- [ ] 已检查与 MEMORY.md / CLAUDE.md 的重叠情况
- [ ] 已验证技术引用的时效性(如果存在工具名称 / CLI 参数 / API,请使用 WebSearch 进行验证)
- [ ] 已考虑使用频率

判定标准:

判定含义
Keep有用且最新
Improve值得保留,但需要特定改进
Update引用的技术已过时(通过 WebSearch 验证)
Retire质量低、陈旧或成本不对称
Merge into [X]与另一技能有大量重叠;命名合并目标

评估是整体 AI 判断 — 不是数字评分标准。指导维度:

  • 可操作性:代码示例、命令或步骤,让你可以立即行动
  • 范围契合度:名称、触发器和内容保持一致;不过于宽泛或狭窄
  • 独特性:价值不能被 MEMORY.md / CLAUDE.md / 其他技能取代
  • 时效性:技术引用在当前环境中有效

原因质量要求 — reason 字段必须是自包含且能支持决策的:

  • 不要只写“未更改” — 始终重述核心证据
  • 对于 Retire:说明 (1) 发现了什么具体缺陷,(2) 有什么替代方案覆盖了相同需求
    • 差:"Superseded"
    • 好:"disable-model-invocation: true already set; superseded by continuous-learning-v2 which covers all the same patterns plus confidence scoring. No unique content remains."
  • 对于 Merge:命名目标并描述要集成什么内容
    • 差:"Overlaps with X"
    • 好:"42-line thin content; Step 4 of chatlog-to-article already covers the same workflow. Integrate the 'article angle' tip as a note in that skill."
  • 对于 Improve:描述所需的具体更改(哪个部分,什么操作,如果相关则说明目标大小)
    • 差:"Too long"
    • 好:"276 lines; Section 'Framework Comparison' (L80–140) duplicates ai-era-architecture-principles; delete it to reach ~150 lines."
  • 对于 Keep(快速扫描中仅 mtime 更改):重述原始判定理由,不要写“未更改”
    • 差:"Unchanged"
    • 好:"mtime updated but content unchanged. Unique Python reference explicitly imported by rules/python/; no overlap found."
第 3 阶段 — 摘要表
技能7天使用判定原因
第 4 阶段 — 整合
  1. Retire / Merge:在用户确认之前,按文件呈现详细理由:
    • 发现了什么具体问题(重叠、陈旧、引用损坏等)
    • 什么替代方案覆盖了相同功能(对于 Retire:哪个现有技能/规则;对于 Merge:目标文件以及要集成什么内容)
    • 移除的影响(是否有依赖技能、MEMORY.md 引用或受影响的工作流)
  2. Improve:呈现具体的改进建议及理由:
    • 更改什么以及为什么(例如,“将 430 行压缩至 200 行,因为 X/Y 部分与 python-patterns 重复”)
    • 用户决定是否采取行动
  3. Update:呈现已检查来源的更新后内容
  4. 检查 MEMORY.md 行数;如果超过 100 行,则建议压缩

结果文件模式

~/.claude/skills/skill-stocktake/results.json:

evaluated_at:必须设置为评估完成时的实际 UTC 时间。 通过 Bash 获取:date -u +%Y-%m-%dT%H:%M:%SZ。切勿使用仅日期的近似值,如 T00:00:00Z。

json
{
  "evaluated_at": "2026-02-21T10:00:00Z",
  "mode": "full",
  "batch_progress": {
    "total": 80,
    "evaluated": 80,
    "status": "completed"
  },
  "skills": {
    "skill-name": {
      "path": "~/.claude/skills/skill-name/SKILL.md",
      "verdict": "Keep",
      "reason": "Concrete, actionable, unique value for X workflow",
      "mtime": "2026-01-15T08:30:00Z"
    }
  }
}

注意事项

  • 评估是盲目的:无论来源如何(ECC、自创、自动提取),所有技能都应用相同的检查清单
  • 归档 / 删除操作始终需要明确的用户确认
  • 不按技能来源进行判定分支

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/zh-CN/skills/skill-stocktake of affaan-m/ECC.

Open the folder on GitHubat commit 2d515e4

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in affaan-m/ECC, which our catalogue first saw on October 9, 2026.

Compare with similar skills

Skill Stocktake next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Stocktake compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Stocktake this skillaffaan-m/ECC277k3 repos~1.2kAutomated safety check: PassMIT
Code Improvertrailofbits/skills7.5k—~1.8kAutomated safety check: NotesCC-BY-SA-4.0
Skill Improvertrailofbits/skills7.5k—~2.1kAutomated safety check: NotesCC-BY-SA-4.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Plugin Settings Patternanthropics/claude-plugins-official38k7 repos~3kAutomated safety check: PassApache-2.0
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT

Similar skills

  • Code Improver

    trailofbits/skills

    Official

    Runs an autonomous review-and-fix improvement loop over any code target — a skill, plugin, module, or directory — using a reviewer the user names: any installed skill or agent.

    7.5k GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Skill Improver

    trailofbits/skills

    Official

    Runs an autonomous review-and-fix improvement loop over a Claude Code skill until a review comes back clean, with a cross-round findings ledger, escalation when fixes stop converging, and a…

    7.5k GitHub stars~2.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    105k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Works with

Categories

Questions about Skill Stocktake

What does Skill Stocktake do?

用于审计Claude技能和命令的质量。支持快速扫描(仅变更技能)和全面盘点模式,采用顺序子代理批量评估. An agent skill from affaan-m/ECC. Skill Stocktake is an agent skill from affaan-m/ECC.

When should I use Skill Stocktake?

Skill Stocktake fits situations like: tasks that involve Skill management.

How do I install Skill Stocktake in Claude Code?

Run `npx skills add affaan-m/ECC --skill skill-stocktake -a claude-code`. Or copy the skill folder (docs/zh-CN/skills/skill-stocktake in affaan-m/ECC) into .claude/skills/skill-stocktake in your project. Claude Code loads it when a task matches its description.

How do I install Skill Stocktake in Codex?

Run `npx skills add affaan-m/ECC --skill skill-stocktake -a codex`. Or copy the skill folder (docs/zh-CN/skills/skill-stocktake in affaan-m/ECC) into .agents/skills/skill-stocktake in your project. Codex loads it when a task matches its description.

Can I use Skill Stocktake in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill skill-stocktake -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-stocktake, .gemini/skills/skill-stocktake, .github/skills/skill-stocktake and .opencode/skills/skill-stocktake in your project.

What does Skill Stocktake need to run?

Going by SKILL.md and its folder, Skill Stocktake needs the command-line tools its instructions call (bash). Our summary lists: Python 3.

Does Skill Stocktake access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Stocktake safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Stocktake use?

Skill Stocktake is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Stocktake use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Stocktake?

Skills that share tags, products or a category with Skill Stocktake: Code Improver (trailofbits/skills, 7.5k stars), Skill Improver (trailofbits/skills, 7.5k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars) and Plugin Settings Pattern (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Stocktake?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.