Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and clearly organized as executable jq/bash recipes, with no padding over concepts Claude already knows. Its main weaknesses are repetition that could be tightened and a long monolithic structure that would benefit from offloading detail into reference files.
Suggestions
Remove the per-snippet PROJECT/SESSION variable re-declarations in favor of a single 'Variables' setup block referenced once, and drop or trim the 'Quick Reference Commands' table that duplicates commands already shown in detail.
Move the 'Export Formats' and 'Advanced Analysis' sections into separate reference files (e.g. references/exports.md, references/advanced.md) linked from a concise overview, to apply progressive disclosure and shrink the main SKILL.md.
Factor the repeated 'select(.type == "assistant") | .message.content[]? | select(.type == "tool_use") | .name' tool-frequency pattern into a named jq filter or a small scripts/ helper to reduce duplication across the tool-stats and comparison sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense and assumes Claude's competence, but the repeated PROJECT/SESSION variable blocks in nearly every snippet and a 'Quick Reference Commands' table that restates already-shown commands are content that could be tightened, fitting the score-2 anchor over the 'every token earns its place' bar of score 3. | 2 / 3 |
Actionability | Dozens of complete, copy-paste-ready jq/bash pipelines (e.g. 'select(.type == "assistant") | .message.content[]? | select(.type == "tool_use") | .name | sort | uniq -c') with concrete example UUIDs/projects match the fully-executable score-3 anchor. | 3 / 3 |
Workflow Clarity | Each analysis task is a clearly sequenced, self-contained recipe and the Usage Examples map natural queries to commands; operations are read-only log analysis with no destructive/batch steps requiring validation checkpoints, so the score-2 cap does not apply. | 3 / 3 |
Progressive Disclosure | It is well-organized into clear sections (above the monolithic score-1 anchor), but at ~300 lines with no bundle files and no external references it keeps detail that could be split (export formats, advanced analysis) inline, falling short of the one-level-deep-reference structure expected at score 3. | 2 / 3 |
Total | 10 / 12 Passed |