Content
86%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 an exemplary instruction-only skill: lean, dense with non-obvious project rules, and concrete about tools, actions, file paths, and schemas, with clear guardrails against substitution and fabrication of components. The only gaps are minor: no example report/search payload, an unspecified 'structured standard filters' mechanism, and no explicit schema-verification step in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~28-line body is lean with every sentence carrying non-obvious, project-specific knowledge ('The catalog establishes what the installed runtime can actually construct', 'Do not encode substitutions as string rules', 'A partial candidate is never permission to substitute'). No concepts Claude already knows are re-explained and nothing is padded, matching anchor 5: every token earns its place. | 5 / 5 |
Actionability | Guidance is concrete and executable: specific tool invocations with parameters and paths (`cad.catalog` with `action="search"`/`"detail"`/`"acquire"`, `cad.edit` `action="import"`, `cad/research/parts/<wave>/*.json`, `cadPartPlanSchema`) plus a defined exact/partial/rejected taxonomy. It stops short of anchor 5 only because no example payload or report structure is given and 'structured standard filters' is left unspecified — minor gaps, consistent with anchor 4. | 4 / 5 |
Workflow Clarity | Two clearly sequenced numbered workflows (research steps 1-6, main-agent handoff steps 1-4) with real checkpoints: candidate classification (step 5), the unresolved-item rule ('report it as unresolved and state the smallest concrete choice the user must make'), and preservation of unresolved items in the part plan. It is anchor 4 rather than 5 because there is no explicit validate-and-verify step (e.g., confirming the report against its schema) and no error-recovery loop around the acquire/import step. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, no bundle files (references/, scripts/, assets/) exist, and none are needed; the body is organized into two well-labeled sections ('## Research workflow', '## Main-agent handoff') with no dangling or buried references. Per the under-50-lines guideline this matches anchor 5: well-organized sections with no need for external references. | 5 / 5 |
Total | 18 / 20 Passed |