Content
53%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 contains one genuinely useful, concrete section (Pattern Matching with status/task markers and track ID format) surrounded by generic boilerplate and a broken code fence. It is executable at a basic level but lacks the actual validation logic its description promises.
Suggestions
Fix the broken opening code fence before the 'ls -la conductor/' commands so the block renders as intended.
Replace the generic 'Instructions' bullets with the actual validation rules, e.g. criteria for what makes index.md/tech-stack.md complete and how to flag failures.
Remove or rewrite the templated 'Use this skill when / Do not use this skill when' sections, which substitute the literal phrase 'check if conductor directory exists' into nonsensical sentences.
Add a validation checkpoint after the file-existence checks describing what to report when required files are missing or status markers are malformed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short overall, but it carries generic filler ('Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes. Provide actionable steps and verification.') and templated 'Use this skill when / Do not use this skill when' boilerplate that adds no skill-specific value. It is not a 2 because it is not severely verbose, and not a 4 because the filler sections are genuinely unnecessary. | 3 / 5 |
Actionability | Provides concrete executable commands ('ls -la conductor/', 'ls conductor/index.md conductor/product.md ...') and concrete pattern examples, but the opening code fence is never opened (broken markdown) and there is no actual validation logic beyond listing files. It is not a 4 because the commands tell Claude what to inspect without telling it how to judge correctness. | 3 / 5 |
Workflow Clarity | A rough sequence is present (check directory exists, find track dirs, check required files), but there are no validation checkpoints or feedback loops for what to do when files are missing or malformed. Per the batch/verification cap, a verification skill without validation steps cannot exceed 3; it is above a 2 because the steps are ordered and named. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references and is organized into labeled sections (Use this skill when, Do not use, Instructions, Pattern Matching). It is not a 5 because the top code block has a broken opening fence and the templated sections are awkwardly organized. | 4 / 5 |
Total | 13 / 20 Passed |