Content
93%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.
An exceptionally well-constructed skill body: lean, copy-paste-ready, bilingual (JS/TS and Python) examples, and clean one-level-deep disclosure into six real reference files. The single weakness is the absence of explicit fix-and-retry loops around the validation steps it already defines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and command-driven with essentially no padding: a two-sentence domain intro, a template-selection table, terse rules, and bare command blocks. It assumes competence (e.g. "Skip the steps that do not apply when modifying an existing Actor") and never explains concepts Claude already knows; detail is pushed to references/. The repeated --user-agent flag is copy-paste-serving, not verbosity. | 5 / 5 |
Actionability | Every step is executable: exact CLI commands (`apify create <actor-name> -t <template-id>`), a concrete template matrix, copy-paste aborting handlers in both JS/TS (`Actor.on('aborting', async () => {...})`) and Python, proxy-setup calls per language, and charge/limit-check calls. Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The 9-step workflow is clearly sequenced with an explicit completion criterion on nearly every step ("Done when <name>/.actor/actor.json exists", "Done when the run ends with status SUCCEEDED") plus validation commands (`apify validate-schema`, local `apify run` before `apify push`, user confirmation before deploy). However, no explicit error-recovery feedback loops are written (no "if validation fails, fix and re-run" guidance), which the 5 anchor requires — it fits the 4 anchor with only that gap. | 4 / 5 |
Progressive Disclosure | SKILL.md is a true overview: schema authoring, actor.json, standby mode, logging, and README guidelines are each one well-signaled markdown link away (references/input-schema.md, output-schemas.md, actor-json.md, standby-mode.md, logging.md, actor-readme.md — all verified to exist), one level deep, with bulk detail correctly out of the main file. Navigation is easy and every section earns its tokens. | 5 / 5 |
Total | 19 / 20 Passed |