Content
82%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 tight, highly actionable skill body that avoids padding entirely and includes explicit validation gates for a batch operation. The main weaknesses are a subtly broken scan command (rg -c on a single file defeats the awk filter), no error-recovery loop behind the Quality Gates, and a Merge Protocol section that only details workflow steps 3-6.
Suggestions
Fix the citation-count command: 'rg -c' on a single file prints a bare count, so the awk '$2 >= 3' filter never matches. Use 'rg -o "LES-[0-9]+" .opencastle/logs/events.ndjson | sort | uniq -c | sort -rn' (same pattern as the second command) so per-lesson counts are actually produced.
Add an explicit error-recovery loop after the Quality Gates: state what to do when a gate fails (e.g., revert the target-file edit, keep the lesson un-archived, and re-draft), which would lift workflow_clarity to the top anchor.
Add concrete commands for the Quality Gates (e.g., the 'keyword search' gate: 'rg "<rule keyword>" <target file>') and cover workflow steps 1-2 in the Merge Protocol so every numbered step has matching detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every token earns its place: a dense criteria table, a six-step numbered workflow, exact edit/attribution/archive templates, and terse anti-patterns — no concept explanations, no padding. Matches anchor 5 ('lean and efficient; assumes Claude's competence'); anchor 4 would require trimmable over-explanation, of which there is none. | 5 / 5 |
Actionability | Mostly copy-paste-ready: exact attribution comment ('<!-- Merged from LES-XXX -->'), exact archive heading format, and concrete rg/awk commands. However, the first scan command is subtly broken — 'rg -c' on a single file prints a bare count, so the 'awk -F: '$2 >= 3'' filter matches nothing and yields no output — and Quality Gates like 'keyword search confirms the merge' give no concrete command. Anchor 4 (concrete commands with minor gaps) fits; not 5 because one provided command is not actually executable as written. | 4 / 5 |
Workflow Clarity | Clear numbered 1-6 sequence plus an explicit Quality Gates checklist (so the destructive/batch cap does not apply), but there is no error-recovery loop — nothing says what to do when a gate fails — and step 6's 'run validation checks' is not concretized into a command. Anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') fits; not 5 because anchor 5 requires feedback loops for error recovery. | 4 / 5 |
Progressive Disclosure | Well-organized single-file skill with clear section headers (Run Criteria, Workflow, Merge Protocol, Quality Gates, Anti-Patterns) and no content that belongs in separate files, though at ~80 body lines it exceeds the under-50-line exception for a top score. The 'Merge Protocol' subsections numbered '### 3' through '### 6' cover only steps 3-6 of the workflow, a minor organizational asymmetry. Anchor 4 (good structure, minor organization gaps) is the best fit. | 4 / 5 |
Total | 17 / 20 Passed |