Content
96%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.
An exemplary lean, fully executable skill body: concrete commands, documented outputs, and a validation-gated workflow with a fix-before-pass loop. The only weakness is the dense external-pointer sentence in workflow step 1 referencing vendored originals outside the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean: every line is a command, output contract, or workflow rule ('Exit code 0 = pass. Non-zero prints diagnostics; fix every one before setting bom_ready: true.'). There is no explanation of concepts Claude already knows, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Commands are copy-paste executable with real example queries ('parts_search.py "ESP32-S3-WROOM-1" --limit 5', '"100nF 0402" --limit 5 --full'), output fields are documented ('lcsc (C-number), mfr, package, stock, price, description'), and the validation invocation plus exit-code semantics are fully specified. This matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The 7-step workflow is clearly sequenced with an explicit validation gate and feedback loop: run bom_validate.py, 'fix every one' diagnostic before setting the gate, and 'Set bom_ready: true only when it passes and no design-critical item is unresolved'. Unresolved rows are explicitly kept visible under unresolved_items rather than hidden. This matches the score-5 anchor with explicit validation and error-recovery guidance. | 5 / 5 |
Progressive Disclosure | Good structure overall: the body stays an overview, the row contract is correctly split into references/hardware-bom-schema.md (a real bundle file), and both scripts are real and referenced. However, workflow step 1 crams pointers to external vendored originals ('<repo>/reference/replicator-original/ee/bom-finalizer/references/' and '.../ee/component-selection/SKILL.md') — files outside the skill's own bundle — into one dense sentence, which is a minor navigation and organization gap fitting the score-4 anchor rather than the clean one-level-deep score-5 anchor. | 4 / 5 |
Total | 19 / 20 Passed |