Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-structured skill body: efficient prose, executable commands, a clear reference split, and genuinely non-obvious evidence rules. The only weaknesses are the placeholder script path, which blocks copy-paste execution, and the absence of failure-handling guidance for the analyzer run.
Suggestions
Resolve the placeholder path: replace "/path/to/claude-usage-analyst/scripts/analyze_claude_usage.py" with the actual skill-relative invocation (e.g., "python3 scripts/analyze_claude_usage.py" run from the skill directory) so commands are copy-paste ready and consistent with step 3.
Add a brief failure-handling step for the analyzer run (e.g., 'If the script reports ccusage not found or a JSON parse error, install/update ccusage and re-run') to close the workflow's validation gap.
Clarify the 5-hour block and rank/median fields in one sentence each or defer them to references/explanation-guide.md so the Output Shape section can stay lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: no concept tutorials, just tool commands, scope caveats, and output-shape rules — every line carries non-obvious guidance such as saying "quota-like pressure" when plan accounting is unknown. It matches the 'every token earns its place' anchor rather than the score-4 anchor with trimmable over-explanation. | 5 / 5 |
Actionability | Commands are concrete and mostly executable ("ccusage --version", "npm install -g ccusage@latest", "--model-a fable --model-b opus-4-8"), but step 2 uses a literal "/path/to/claude-usage-analyst/scripts/analyze_claude_usage.py" placeholder while step 3 uses the relative "scripts/analyze_claude_usage.py", so it is not copy-paste ready without resolving the path. That is a minor gap (anchor 4), not missing key details (anchor 3). | 4 / 5 |
Workflow Clarity | The four-step sequence is clear and step 1 includes a tool-availability check with an npx fallback, but there is no error-recovery guidance (e.g., what to do if the analyzer exits with a ccusage parse failure). That places it at 'clear sequence with most checkpoints present; minor validation gaps' rather than the score-5 feedback-loop anchor; no destructive/batch cap applies since the skill only reads usage logs. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview and both bundle paths are real, purpose-signaled, and exactly one level deep: "Read `references/explanation-guide.md` when writing the final answer" and the bundled analyzer script. Detail (plain-language translations, interpretation patterns, caveats) is appropriately split out rather than inlined, matching the anchor-5 structure. | 5 / 5 |
Total | 18 / 20 Passed |