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 is highly actionable and the connection workflow has explicit state-based checkpoints, but token efficiency suffers from an empty resource bullet-tree and persona padding, and all detail lives in one file with no progressive disclosure. Broken cross-references ("Step 2") and absent run-monitoring guidance are the main clarity gaps.
Suggestions
Cut the Apify Overview bullet tree and the user-persona sentence; replace with one line naming the resource types or move the taxonomy into a reference file.
Fix the dangling "skip to Step 2" references (there is no Step 2 heading) and add a short workflow for monitoring an async run to completion (e.g., poll get-run until status is terminal).
Move the Popular actions catalog and proxy flag table into a references/ file, keeping a handful of high-frequency actions inline, so SKILL.md stays an overview with one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The command sections are tight, but there is real padding: the "used by data scientists, marketers, and researchers" persona sentence, the 18-line "Apify Overview" bullet tree whose sub-entries are just "Run"/"Record"/"Request" plus the vacuous "Use action names and parameters as needed.", and the "so you can focus on the integration logic rather than auth plumbing" aside. Not a 4 because these unnecessary explanations go beyond minor instances. | 3 / 5 |
Actionability | Nearly every section gives copy-paste-ready commands (npm install, membrane login with headless variant, connection ensure, action list/run with --input, request with a flags table), and the Popular actions table catalogs 19 concrete actions. Not a 5 because the run examples stay at placeholder level (no worked end-to-end example with a real actionId and input) and the table gives keys where the run command needs an actionId. | 4 / 5 |
Workflow Clarity | The setup sequence is clear with genuine checkpoints: poll with --wait, state-by-state handling of READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR, and re-poll after user action. Not a 5 because "skip to Step 2" references a step that is never defined (and "1b" has no "1a"), and there is no guidance on monitoring an async run to completion after Run Actor/Run Task returns immediately. | 4 / 5 |
Progressive Disclosure | The single SKILL.md has clear section headers, but there is no bundle at all — the 19-row Popular actions catalog and the proxy flag table are exactly the bulk material a reference file would hold, and everything is inlined. Anchor 3 ("content that should be separate is inline") fits better than 4 given ~165 lines with zero one-level-deep references. | 3 / 5 |
Total | 14 / 20 Passed |