Content
90%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.
An excellent, tightly written single-file skill: fully executable commands, lean Sem-specific guidance, explicit safety boundaries (sem check hazard, no auto-install, scoped edits), and thoughtful validation/fallback handling. The only improvements are structural - adding a few section headers and making the implicit workflow order explicit.
Suggestions
Add 2-3 short section headers (e.g. 'Queries', 'Diff and review', 'Boundaries') so the headerless prose blocks are scannable at a glance.
Make the implicit workflow order explicit (1. verify sem --version, 2. choose the smallest query, 3. fall back to text search when results are incomplete, 4. report with source locations) so the checkpoints are ordered rather than implied.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero padding: every sentence adds non-obvious, Sem-specific knowledge (version pinning vs GNU sem, env prefixes, disambiguation flags, the sem check execution hazard). It fully assumes Claude's competence and every token earns its place, matching the 5 anchor; the 4 anchor's 'minor instances of over-explanation' are absent. | 5 / 5 |
Actionability | The five ready-to-run commands in the code block are complete and executable as written (env prefix, --json, concrete --budget value), and the surrounding prose gives specific flags (--in, --file) and a concrete diff pattern (BASE..HEAD substitution). This matches 'copy-paste ready commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | There is a clear implicit sequence (version check -> smallest query -> fallbacks -> report with source locations) plus validation and fallback guidance (sem --version gate, empty-result-is-not-proof, fall back to text search), fitting 'clear sequence with most checkpoints present'. Not 5 because the flow is presented as principles rather than an ordered sequence, so checkpoints are implicit; not 3 because the version check and fallback guidance are explicit. | 4 / 5 |
Progressive Disclosure | This is an under-50-line single-file skill with no bundle files, and all content appropriately lives inline in one coherent flow. Structure is good but the body mixes query guidance, fallback strategy, review reporting, and safety constraints with no section headers beyond the H1, which is a minor organization gap per the 4 anchor; not 5 because the simple-skill exception still presumes well-organized sections. | 4 / 5 |
Total | 18 / 20 Passed |