Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced skill with executable inline implementations and thorough edge-case handling. Its main weaknesses are length/verbosity and a monolithic structure that does not progressively disclose operation details into separate reference files.
Suggestions
Move the per-operation output templates and the density benchmark tables into a references file (e.g. graph-output-formats.md), keeping SKILL.md as an overview that links to each operation, to improve progressive disclosure.
Tighten the Philosophy section and trim repeated boilerplate in the presentation blocks to reduce token cost without losing the actionable code.
Confirm whether the referenced ops/scripts/graph/*.sh and ops/derivation-manifest.md are intended as skill bundle files; if so, ship them under scripts/ and references/ so the inline code is a true fallback rather than the only path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is comprehensive and mostly operational, but ~550 lines with a Philosophy section and lengthy templated output blocks ('--=={ graph health }==--' etc.) could be tightened; not every token earns its place. | 2 / 3 |
Actionability | Each operation ships executable bash and ripgrep patterns (e.g. the orphan/dangling grep loops, 'rg "^{field}:.*{value}"'), copy-paste ready with specific one-liners. | 3 / 3 |
Workflow Clarity | Every operation is explicitly sequenced (Step 1: Collect → Step 2: Interpret) and edge-case recovery is handled ('Did you mean: ...', 'Note not found ...'); operations are read-only so destructive-validation caps do not apply. | 3 / 3 |
Progressive Disclosure | The skill is a single monolithic file with no bundle files (references/scripts/assets absent); it is well-sectioned but content for nine operations is inline rather than split into one-level-deep reference files. | 2 / 3 |
Total | 10 / 12 Passed |