Content
63%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 delivers a clear, well-sequenced workflow with mostly executable commands and useful error recovery, but its central script is missing from the bundle and the large actor table is inlined rather than split out. Tightening JSON_INPUT guidance and moving the catalog to a reference file would materially improve it.
Suggestions
Move the 28-row Actor selection table to a reference file (e.g., references/actors.md) and keep only a few representative examples inline in SKILL.md.
Add a concrete example showing how to translate the schema fetched in Step 2 into the JSON_INPUT string used in Step 4, since that handoff is currently implicit.
Include a verification checkpoint after Step 4 (e.g., check exported row count or preview the file) to close the feedback loop for batch scraping runs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Steps are lean with a terse error-handling table and no explanation of concepts Claude already knows, but there is minor fluff to trim — the odd parenthetical "(No need to check it upfront)" and the vague "Number of results: Based on character of use case". | 4 / 5 |
Actionability | The mcpc schema-fetch command and the three node script invocations with format flags are concrete, but every run command depends on ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js, which is absent from the bundle, and no example shows how to build JSON_INPUT from the schema fetched in Step 2. | 3 / 5 |
Workflow Clarity | A tracked 5-step checklist with a clear sequence and an error-handling section giving recovery actions for common failures, but there is no output verification step (e.g., checking row counts or inspecting the exported file) after batch scraping runs. | 4 / 5 |
Progressive Disclosure | Sections are well organized, but the 28-row Actor catalog is bulk reference data inlined in SKILL.md that belongs in a separate file, and the only file reference (reference/scripts/run_actor.js) does not exist in the bundle. | 3 / 5 |
Total | 14 / 20 Passed |