Content
92%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.
A well-engineered operational skill: fully executable queries and script commands, explicitly sequenced phases with validation loops and a thorough error-handling matrix, and clean one-level-deep disclosure into real reference and script files. The main trim opportunity is redundancy between the Anti-Patterns section and the Error Handling table, plus maintainer-only footer content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — API endpoints, exact query strings, script invocations, and an output template with almost no concept explanations Claude already knows. Not 5: the 10-bullet 'Anti-Patterns To Reject' section substantially duplicates the Error Handling table, and the maintainer footer (source spec, build pattern, '/cs-grill-with-docs' re-grill note) is internal bookkeeping that earns no runtime tokens. Not 3: the padding is minor relative to the whole — no multi-paragraph explanations of known concepts. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact API calls ('reddit.com/search.json', 'search?query=<topic>&numericFilters=created_at_i><timestamp>&tags=story'), concrete script commands with flags ('scripts/time_window_calculator.py --window <Nd>', 'citation_tracker.py --action record_sent --session NAME --query "..."'), a copy-paste-ready output template, and a runnable Phase-4 import command. Not 4: the common cases are covered end-to-end with specific commands, not just patterns. | 5 / 5 |
Workflow Clarity | Phases 0–4 are explicitly sequenced with parallel/sequential boundaries stated, stop conditions ('After Q4 (or earlier with dependency skips)... Max 4 questions, never bundle'), a retry policy with failure ceilings, a three-count audit validation loop, and a comprehensive Error Handling table with recovery behavior per failure mode. Not 4: validation checkpoints and feedback loops (retry once → stop after 3 failures, refuse-mush pushback, never deliver an empty file) are explicit and pervasive. | 5 / 5 |
Progressive Disclosure | SKILL.md is an operational overview with well-signaled, one-level-deep references — 'See references/research_pack_conventions.md for the canon', 'See references/cross_platform_synthesis.md for detection heuristics' — plus a Tooling table and a References section describing each file's role; all six referenced files exist in the bundle. Not 4: every reference is signaled at point of use, listed with roles, exactly one level deep, and the remaining inline content (queries, output template) is core workflow that belongs in the main file. | 5 / 5 |
Total | 19 / 20 Passed |