Content
33%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 is a well-intentioned but hollow shell: it is token-lean yet delivers essentially no actionable guidance, with an empty Instructions section, no workflow or validation steps, and 12 dangling references to sub-skill files absent from the bundle. As written, invoking the skill gives Claude nothing to execute.
Suggestions
Populate the empty "Instructions" section with a sequenced workflow (e.g., gather requirements → select architecture → implement ingestion/transformation → validate data quality → deploy monitoring) with explicit validation checkpoints, which is mandatory for batch operations per the rubric.
Ship the 12 referenced ./sub-skills/ files or remove the links and inline the essential guidance; fix the duplicate numbering so each knowledge module has a unique identifier.
Add at least a few executable examples (an Airflow DAG skeleton, a dbt model, or a Great Expectations suite) so the capability bullets translate into copy-paste-ready guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows and a tight capability list; the only waste is the persona line repeating the frontmatter description verbatim and an empty "Instructions" header, which keeps it just below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | "Core Capabilities" offers high-level hints ("Build workflow orchestration with Airflow/Prefect", "Transform data using dbt and Spark") but no code, commands, or specific steps, and the "Instructions" section is literally empty while all 12 sub-skill links point to files that do not exist in the bundle. It is not 1 because the named technologies give some concrete anchors, and not 3 because no guidance in the body is executable. | 2 / 5 |
Workflow Clarity | The body contains no steps or sequence at all — pipeline design, implementation, and monitoring are multi-step batch operations, yet no workflow, ordering, or validation checkpoints are stated anywhere, matching the 'steps missing; no validation' anchor. | 1 / 5 |
Progressive Disclosure | The 12 sub-skill references are listed one level deep and clearly signaled, but none of the referenced ./sub-skills/ files exist in the bundle, so progressive disclosure resolves to nothing; duplicate module numbering (two series both starting at "1.") and the empty "Instructions" header make navigation further broken. Not 3 because the references do not resolve to real content, and not 1 because the SKILL.md itself is sectioned and references are not buried or nested. | 2 / 5 |
Total | 9 / 20 Passed |