Content
67%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 skill body is well structured with a clear five-step workflow, a concrete Actor decision table, explicit commands, and unusually good safety and billing boundaries for a paid scraping skill. Its main weaknesses are that the entire workflow hinges on a bundled script that is absent from this bundle, and the Run Boundaries section is a dense wall of rules that would be clearer as a list. A minor validation gap exists: results are summarized but never verified after a run.
Suggestions
Ship the referenced runner script (verify the actual path — the body says `reference/scripts/run_actor.js` but no scripts/ or references/ directory exists in the bundle) or inline the REST call so the commands are executable as written.
Break the single-paragraph "Run Boundaries" section into a bulleted list so each billing, privacy, and limit rule is individually scannable.
Add a post-run validation step in Step 5 (e.g., check the output file exists and record count matches the run's returned item count) to close the feedback loop for this paid batch operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean overall: a decision table for Actor selection, tight command blocks, a compact error table, and no explanations of concepts Claude already knows. Not 5 because the "Run Boundaries" section crams roughly nine distinct rules into a single dense paragraph and partially repeats Prerequisites (token privacy), which could be trimmed or split. Not 3 because there is no padding or unnecessary over-explanation. | 4 / 5 |
Actionability | Commands are concrete in shape — `node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" --actor "ACTOR_ID" --input 'JSON_INPUT'` with explicit `--output`/`--format` flags and a real error-handling table — but every invocation depends on `run_actor.js`, which does not exist in the bundle (no references/, scripts/, or assets/ directory is present), and the placeholders "ACTOR_ID"/"JSON_INPUT" cannot be filled without it. Not 4 because the central executable artifact is missing; not 2 because the command structure, flags, output formats, and Actor IDs are specific and near-executable. | 3 / 5 |
Workflow Clarity | The sequence is explicit (copyable progress checklist, Steps 1–5) with meaningful pre-launch checkpoints — "Verify prerequisites before any paid run", fetch the Actor schema before calling, "confirm the selected Actor, authorized public-data scope, current input schema, result limits and pricing with the user's request" — plus error-recovery guidance ("Inspect the printed run ID in Console before retrying to avoid duplicate charges"). Not 5 because there is no post-run validation step (Step 5 only reports results without verifying output integrity); not 3 because pre-run validation and error-recovery loops are present for this paid batch operation. | 4 / 5 |
Progressive Disclosure | Sections are well organized (When to Use, Prerequisites, Workflow, Error Handling, Run Boundaries, Limitations) and the only external reference is a single one-level-deep script path embedded in the commands, with no nested references. Not 5 because that sole referenced path (`reference/scripts/run_actor.js`) does not exist in the bundle — no such file or directory is shipped — and the 18-row Actor table is arguably reference material inlined in SKILL.md; not 3 because the structure is clean and easy to navigate for a single-file skill. | 4 / 5 |
Total | 15 / 20 Passed |