Content
85%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-structured, highly actionable instruction skill with excellent workflow sequencing, validation feedback loops, and copy-paste-ready templates and lint messages. Its main weakness is that all content — including the large, conditionally-relevant migration criteria — lives in one monolithic SKILL.md with no progressive disclosure, plus a few trimmable redundancies.
Suggestions
Move the 'Migration and Data Conversion Tasks' section (~75 lines) into a references/migration-criteria.md file and signal it one level deep from the body ('For migration/data-conversion tasks, see references/migration-criteria.md for the four mandatory [E] criteria'), keeping SKILL.md as an overview.
Consider splitting the full 'Task Prompt Template' into its own reference file so the core CLEAR/CoVe guidance stays lean, with the template loaded only when emitting a revised task.
Trim redundancy: the persona opening, the 'When to Use This Skill' section duplicating frontmatter triggers, and the overlap between 'The Combined Model' and 'Your Output Responsibilities When Invoked' could each be collapsed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean imperative bullets with no explanation of concepts Claude already knows ('remove filler and meta commentary', 'Avoid vague terms: "handle", "improve"...'). Minor trimming is possible: the persona preamble ('You are a planning/orchestration assistant...'), 'When to Use This Skill' repeating the frontmatter triggers, and overlap between 'Order of operations' and 'Your Output Responsibilities' — efficient but not every token earns its place, so 4 rather than 5. | 4 / 5 |
Actionability | Fully copy-paste-ready guidance for an instruction-only skill: a complete markdown task template, a canonical 8-step section ordering, exact lint messages ('[E]: MISSING — migration task must include a content completeness assertion'), and concrete commands ('grep -h "^status:" real_data/*.md | sort -u', 'uv run plugins/development-harness/scripts/verify_migration_fidelity.py'). Absence of code is not penalized since the guidance is highly actionable, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced ('1. Use CLEAR to structure... 2. Add CoVe only where accuracy risk justifies verification. 3. Control verbosity...') with explicit validation checkpoints and feedback loops ('Revise the output if any check fails or uncertainty remains', 'If any item fails, revise the task prompt'). The pre-finalize linting checklist and scorer-behavior gate provide error-recovery loops, matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | The skill is a single ~285-line file with no references/ bundle; specialized conditional content is inlined — the ~75-line migration section ('four additional [E] criteria are mandatory... before the task scores as CLEAR-compliant') and the swarm-planning guidance apply only to specific task types and could live in one-level-deep reference files. Structure exists (clear headers, template), but content that should be separate is inline, matching anchor 3 rather than 4. | 3 / 5 |
Total | 17 / 20 Passed |