Content
92%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-architected skill body: concise domain-specific invariants, an explicit multi-step workflow with named validation and review checklists, and clean one-level-deep progressive disclosure to four verified reference files. The single weakness is that executable language-specific scaffolding lives in the references rather than as inline copy-paste examples.
Suggestions
Add one short inline copy-paste example (e.g. a minimal start-run-and-poll snippet in JS or Python) so the most common case is executable without opening a reference file, lifting actionability from 4 to 5.
Consider naming 1-2 more natural platform terms (Make, Pipedream, Haystack, Vercel AI SDK) in the description to broaden trigger-term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Apify-specific knowledge Claude lacks — vocabulary mirroring, the bounded-polling invariant, the maxTotalChargeUsd/maxItems cost rule, attribution headers, and the non-idempotent POST /runs retry rule — with no padding of concepts Claude already knows; every section earns its place, matching the 5 anchor. It is not a 4 because there are no trimmable over-explanation passages. | 5 / 5 |
Actionability | Guidance is concrete and specific — exact endpoint paths, the API surface table, exact header names and values (x-apify-integration-platform, x-apify-integration-ai-tool), exact cost-control field semantics — and the run-flow snippet is executable, matching the 4 anchor. It is not a 5 because full language-specific scaffolding code is deferred to the reference files rather than given as copy-paste-ready examples inline. | 4 / 5 |
Workflow Clarity | The 'Working workflow' lays out a 6-step sequence with a required Step-0 prerequisite and an explicit validation checkpoint ('Verify against the definition-of-done checklist at the end of that reference'), supplemented by the 'Top anti-patterns to refuse on review' checklist, matching the 5 anchor's explicit validation and checklists. It is not a 4 because validation is explicitly named rather than merely implied. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with a navigation table mapping each product shape to exactly one one-level-deep reference file, and all four referenced files (workflow-automation.md, ai-harness-plugin.md, ai-framework-package.md, sdk-integration.md) exist in references/, matching the 5 anchor. It is not a 4 because the split is clean and navigation is explicit, with no buried or nested references. | 5 / 5 |
Total | 19 / 20 Passed |