Content
60%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.
A well-structured, mostly lean skill with a clear sequenced workflow, good error handling, and thoughtful safety constraints around paid Actors. Its critical weakness is executability: the referenced runner script is missing from the bundle, Step 2's schema-fetch instructions are incoherent as written, and the large Actor table is inlined rather than split into a reference file.
Suggestions
Ship the referenced run_actor.js (or correct the path) and include one worked example of a complete invocation with a real JSON_INPUT value so Step 4 is copy-paste executable.
Fix Step 2: show the concrete mcpc command that actually contains ACTOR_ID for fetching the actor's input schema, replacing the abstract 'use its discovered fetch-actor-details schema' instruction.
Move the 28-row Actor selection table into a references/ file (e.g. references/actors.md) and keep a short 'how to choose' guide inline, so SKILL.md remains an overview with one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean: terse commands ("node --env-file=.env ... --actor ... --input ..."), a compact error-handling table, and no explanations of concepts Claude already knows, matching the 'efficient; minor instances that could be trimmed' anchor. Not 5 because the dense safety paragraph in Step 3 ('Before starting, verify the selected Actor/build... It identifies this skill through a User-Agent.') crams many constraints into one run-on block, and the timeout/duplicate-run guidance is stated twice (Step 3 and Error Handling). Not 3 because the redundancy is only a couple of sentences and the rest earns its tokens. | 4 / 5 |
Actionability | There is concrete guidance — install commands, "mcpc --json mcp.apify.com tools-list", full node invocations with flags, and an error table — but key executable details are missing, fitting 'some concrete guidance but incomplete; missing key details'. Step 2 says "Replace ACTOR_ID with the selected Actor" yet the shown command contains no ACTOR_ID, and the actual fetch-actor-details invocation is left as an abstract instruction ('use its discovered fetch-actor-details schema'). Step 4 uses undefined placeholders ('JSON_INPUT', 'YYYY-MM-DD_OUTPUT_FILE.csv') with no worked example, and the invoked script "<absolute-skill-root>/reference/scripts/run_actor.js" does not exist in the bundle (no scripts/ directory is present). Not 2 because substantial concrete, runnable scaffolding exists; not 4 because the core run step cannot be executed as written. | 3 / 5 |
Workflow Clarity | A clear five-step sequence with a copyable progress checklist, pre-run checks (prerequisites, "verify the selected Actor/build and ... approved spending cap"), user confirmation before spending, an error-handling section with recovery guidance ("Inspect the existing run; do not create a duplicate run"), and a Step 5 verification report ("Number of competitors actually fetched, missing data") — matching 'clear sequence with most checkpoints present; minor validation gaps'. Not 5 because there is no explicit validate-output-then-fix loop and Step 2's instructions are internally inconsistent; the batch-operation cap of 3 does not apply since verification steps are present. | 4 / 5 |
Progressive Disclosure | The bundle contains no references/, scripts/, or assets/ directories, yet the body's central execution path points to "<absolute-skill-root>/reference/scripts/run_actor.js", a dangling reference to a file that does not exist. Additionally, the 28-row Actor selection table is bulk reference data inlined in SKILL.md that belongs in a separate reference file. This matches anchor 2 ('content that clearly belongs in separate files is inlined; or references are buried' — here the reference is broken). Not 3 because the file organization is not merely improvable: the skill's one file reference is unusable and the body carries the full dataset inline; not 1 because section structure and navigation within SKILL.md itself are clear. | 2 / 5 |
Total | 13 / 20 Passed |