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 genuinely actionable five-step workflow with concrete CLI commands, a useful Actor selection catalog, and unusually strong safety/validation checkpoints for a paid batch operation. Its weaknesses are a dangling reference to a nonexistent runner script, inlined bulk tables, and padded boundary prose that duplicates the description.
Suggestions
Ship the referenced runner at a standard path (e.g. references/scripts/run_actor.js) or remove/inline the run commands, since Step 4 is unexecutable as bundled.
Move the Actor ID tables to a reference file (e.g. references/actor-catalog.md) and keep a short platform summary in SKILL.md to cut inline bulk.
Delete the duplicated description paragraph at the top of the body and split the run-on "Execution and export boundaries" paragraph into short scannable bullets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Actor tables, commands, and step instructions are lean and instructional, but the frontmatter description is repeated verbatim as the body's opening paragraph, and the "Execution and export boundaries" section is one dense padded paragraph mixing many unrelated caveats (including "The repaired runner", a reference to internal history that does not exist in this skill). Mostly efficient with some tightening needed, rather than 'noticeably verbose' across several padded sections. | 3 / 5 |
Actionability | The mcpc and node commands are concrete and copy-paste ready with explained placeholders ("Replace SEARCH_KEYWORDS with 1-3 simple terms", "Replace ACTOR_ID with the selected Actor"), and error handling maps each failure to a specific remedy. Minor gaps keep it from 5: --input 'JSON_INPUT' is never exemplified with a realistic value, and step numbering for "Number of results" is vague. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps with a copyable progress checklist, pre-run checkpoints (fetch schema, check pricing box, "Get explicit approval", "Set a conservative result cap"), and an error-handling section with recovery actions including timeout reconciliation before retry. Minor gaps: no explicit post-run verification of output correctness, and step 3's "Based on character of use case" is ambiguous — so it sits at 'most checkpoints present' rather than the fully validated anchor at 5. | 4 / 5 |
Progressive Disclosure | Section structure is clear (When to Use, Prerequisites, Workflow, Error Handling, Limitations), but the body references "$SKILL_PATH/reference/scripts/run_actor.js" and that file does not exist in the bundle (no references/, scripts/, or assets/ directories are present), and the path uses the nonstandard "reference/" spelling. ~150 lines of Actor tables are inlined rather than split into a reference file, so organization is adequate but not well-signaled or complete. | 3 / 5 |
Total | 14 / 20 Passed |