Content
80%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Concise and highly actionable with a well-sequenced checklist, but it lacks an explicit output-validation checkpoint and references a script file that is not present in any bundle directory.
Suggestions
Add a validation step (e.g. verify the output file exists and report row count) before Step 5 summarization, to satisfy the batch-operation feedback-loop expectation.
Either ship the referenced `reference/scripts/run_actor.js` in a references/ or scripts/ bundle, or inline the script so there are no dangling references.
Consider moving the 17-row Actor selection table into a separate reference file referenced one level deep, keeping SKILL.md as a concise overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: no concept explanations, just a decision table, concrete commands, and short step descriptions — every section earns its place and assumes Claude's competence. | 3 / 3 |
Actionability | Provides copy-paste-ready bash commands with real flags for schema fetch and three output formats; placeholders (ACTOR_ID, JSON_INPUT) are clearly user-supplied inputs rather than vague pseudocode. | 3 / 3 |
Workflow Clarity | A clear 5-step checklist with an Error Handling recovery section is present, but there is no explicit validation checkpoint verifying output before reporting; for a batch data-collection operation this caps the score at 2. | 2 / 3 |
Progressive Disclosure | The body references `${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js`, but no references/ or scripts/ bundle directory exists, so the reference is dangling; the 17-row inline actor table is also content that could live in a separate reference file. | 2 / 3 |
Total | 10 / 12 Passed |