Content
85%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.
The content is a tight, safety-oriented operational guide with an explicit entry workflow, concrete validation criteria, error-recovery loops, and executable commands backed by a real bundled script. It could be marginally leaner (some repetition around not re-checking status) and the MCP-side tooling is slightly less concretely specified than the CLI fallback.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational, with no explanation of concepts Claude already knows, but the 'do not re-check/poll' point is repeated across three sections ('do not call the CLI or MCP merely to keep checking', 'do not poll status on every turn', 'Reuse the result') and the WSL/Windows section carries niche detail, matching anchor 4's 'minor instances of over-explanation that could be trimmed' rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Guidance is mostly executable: a concrete MCP call signature ('get_minimal_context_tool(task=<short task>, repo_root=<root>)') and six copy-paste CLI wrapper commands whose subcommands match the actual bundled script. Minor gaps (the 'available graph-stats tool' is never named, and MCP query names are left generic) place it at anchor 4 rather than anchor 5's fully executable, common-cases-covered level. | 4 / 5 |
Workflow Clarity | The entry workflow is a clear numbered sequence with explicit validation gates: exactly one read-only health check with concrete readiness/staleness criteria ('nodes or files is zero, or last_updated is null'), a retry-once-then-CLI-fallback error loop, a stop condition for stale graphs, and post-mutation verification — matching anchor 5's 'explicit validation steps; feedback loops for error recovery' rather than anchor 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The body is a well-organized, compact overview whose only bundle dependency — 'scripts/crg_readonly.py' — is a real, clearly signaled, one-level-deep reference that exists and matches the documented subcommands. No content that belongs in a separate file is inlined and there are no nested references, so it meets the top anchor for a short, well-structured skill. | 5 / 5 |
Total | 18 / 20 Passed |