Content
67%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 body is a well-sequenced, genuinely actionable workflow with strong error-recovery scaffolding (fallback table, uncertainty ladder, confirmation gates). Its main costs are the meta sections (Success Metrics, Philosophy) that spend tokens without guiding execution, and minor specificity gaps in the search and category-suggestion steps.
Suggestions
Delete or collapse the "Success Metrics" and "Philosophy" sections into one or two lines, e.g. fold "no duplicate saves" into the vault-coverage step — they spend context without instructing Claude.
Enumerate the suggested categories for the Save template (the value /url-dump expects) and give a concrete search command (e.g. grep -ri "<domain> --include='*.md'" over the vault) so the coverage check is copy-paste executable.
Add a quick validation step for vault hits, e.g. read the matched file's frontmatter to confirm it's a true duplicate rather than a passing mention, before recommending skip.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly task-specific procedure, but the "Success Metrics" and "Philosophy" sections are non-actionable padding ("Scout embodies COG's 'evaluate before you accumulate' principle") that Claude cannot use at runtime. Fits the 3 anchor (mostly efficient with some unnecessary explanation) rather than 4, since these are whole sections, not minor instances. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: exact vault paths (00-inbox/MY-PROFILE.md), verbatim prompt templates in code blocks, a defined search strategy, a fallback table, and exact output formats for Save/Skip/batch cases. Minor gaps — suggested categories are never enumerated and the grep strategy is described but not given as a command — keep it below the 5 anchor's fully copy-paste-ready bar. | 4 / 5 |
Workflow Clarity | Seven clearly sequenced steps with real checkpoints: a pre-flight profile check, user-confirmation gates before handoff ("Shall I hand off to /url-dump?"), a batch summary table for batch mode, and Fallback Behavior / Uncertainty Handling sections that act as explicit error-recovery loops. It is not 5 because there is no step validating that vault-search hits are true duplicates or that fetched content was parsed correctly. | 4 / 5 |
Progressive Disclosure | A single well-organized file with clear section headers, no nested or dead references, and no bundle files to mis-navigate. It is not 5 because at ~195 lines the output templates and fallback details could arguably live in one-level-deep reference files, and the rubric's 5-without-references exception applies only to skills under 50 lines. | 4 / 5 |
Total | 15 / 20 Passed |