Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured triage skill with clear, actionable workflows, excellent progressive disclosure via reference files loaded on demand, and strong validation checkpoints throughout. The main weakness is moderate verbosity in the follow-up skills section and self-review criteria, which could be tightened. Overall it is a high-quality skill that effectively guides Claude through complex multi-step triage operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining concepts Claude already knows, but there is some verbosity — e.g., the 'Suggesting follow-up skills' section is lengthy with descriptions of each skill that could be more compact, and the 'Self-Review' section repeats guidance already implicit in the workflows. Some tightening is possible without losing clarity. | 2 / 3 |
Actionability | The skill provides concrete, executable commands (snouty runs --json properties, snouty runs --json logs $RUN_ID $INPUT_HASH $VTIME, snouty doctor, etc.) with specific flags and arguments. Steps are precise about which fields to check, how to match them, and what to do with the results. The guidance is copy-paste ready and specific. | 3 / 3 |
Workflow Clarity | Multiple workflows are clearly sequenced with explicit validation checkpoints (preflight with snouty doctor, checking for null triage_report before proceeding, verifying run status before choosing workflow). The 'Investigate failed properties' workflow includes a feedback loop (download more logs if uncertain, compare passing vs failing). The 'Diagnose incomplete run' workflow has clear fallback steps. Error recovery paths are well-defined. | 3 / 3 |
Progressive Disclosure | The skill is structured as an overview that explicitly references detailed guides in references/ (run-discovery.md, run-info.md, properties.md, logs.md) at the exact points where they are needed, with a clear instruction not to read them all up front. References are one level deep and clearly signaled. The content is well-organized with distinct workflow sections. | 3 / 3 |
Total | 11 / 12 Passed |