Content
37%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides some concrete shell commands and pattern examples but lacks a coherent validation workflow. The Instructions section is generic boilerplate rather than actionable validation steps. For a skill focused on 'validating artifacts for completeness, consistency, and correctness,' it critically lacks expected outputs, pass/fail criteria, and error recovery guidance.
Suggestions
Define a clear numbered validation workflow: 1) Check structure exists, 2) Verify required files, 3) Validate content patterns, with expected outputs and what to do if validation fails
Replace generic Instructions section with specific validation criteria - what makes a conductor project 'complete' vs 'incomplete'?
Add expected output examples for the shell commands so Claude knows what success/failure looks like
Remove boilerplate 'Use this skill when' sections that repeat the skill name without adding value
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill has some redundancy - the 'Use this skill when' and 'Do not use this skill when' sections are boilerplate that don't add value. The shell commands are lean, but the instructions section is generic filler rather than specific guidance. | 2 / 3 |
Actionability | Provides concrete shell commands for checking directory structure, but the Instructions section is vague ('Clarify goals, constraints, and required inputs') rather than specific validation steps. Pattern matching examples are concrete but disconnected from a validation workflow. | 2 / 3 |
Workflow Clarity | No clear validation workflow is defined. Shell commands are listed without sequence, expected outputs, or what to do if checks fail. For a validation skill, missing feedback loops and error handling is a significant gap. | 1 / 3 |
Progressive Disclosure | References implementation-playbook.md for detailed examples, which is appropriate one-level-deep disclosure. However, the main content organization is poor - pattern matching examples appear disconnected from the validation purpose, and there's no clear overview structure. | 2 / 3 |
Total | 7 / 12 Passed |