Investigate the history, usage, and liveness of code using search and git blame/log. Use when determining if code is dead, understanding why something exists, finding all callers before refactoring, or deciding whether something is safe to remove. Also useful for answering "who added this and why" or "is anything still using this".
79
100%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly articulates specific capabilities (code history investigation via git blame/log), provides explicit trigger conditions with a 'Use when' clause, and includes natural language phrases users would actually say ('who added this and why', 'is anything still using this'). It occupies a distinct niche that is unlikely to conflict with other skills while being highly discoverable for its intended use cases.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'investigate history, usage, and liveness of code', 'search and git blame/log', 'determining if code is dead', 'finding all callers before refactoring', 'deciding whether something is safe to remove'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Investigate the history, usage, and liveness of code using search and git blame/log') and when ('Use when determining if code is dead, understanding why something exists, finding all callers before refactoring, or deciding whether something is safe to remove'). Has an explicit 'Use when' clause with multiple trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'dead code', 'git blame', 'git log', 'refactoring', 'callers', 'who added this and why', 'is anything still using this', 'safe to remove'. These closely match how developers naturally phrase these questions. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around code archaeology and liveness analysis using git history tools. The specific focus on dead code detection, blame investigation, and pre-refactoring caller analysis distinguishes it well from general code search or refactoring skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill that is lean, actionable, and well-structured. It provides concrete executable commands, a clear decision framework for interpreting results, and a structured output format — all without wasting tokens explaining concepts Claude already knows. The investigative nature of the task is well-served by the flexible 'pick what you need' approach rather than a rigid workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place. No explanation of what git blame is or how grep works — it jumps straight to the specific patterns Claude needs. The decision framework table is dense and useful. No filler. | 3 / 3 |
Actionability | Provides fully executable git and grep commands with concrete flags and patterns. The git commands reference section is copy-paste ready, and the techniques section shows exactly how to interpret results (e.g., 'classify hits as definition, test, re-export, or real caller'). | 3 / 3 |
Workflow Clarity | The skill explicitly says 'pick whichever techniques are useful' rather than forcing a rigid sequence, which is appropriate for an investigative task. The decision framework table provides clear validation checkpoints (what evidence leads to what verdict), and the output format gives a structured 5-step reporting sequence. The workflow naturally includes verification (checking transitive usage, checking re-exports). | 3 / 3 |
Progressive Disclosure | For a standalone skill under 50 lines with no need for external references, the content is well-organized into logical sections: techniques, decision framework, output format, and command reference. The structure supports quick scanning and progressive depth. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
f5efc36
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.