Content
61%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 action-dense with executable CLI commands and a useful flag table, but it carries unnecessary conceptual preamble, references an unlabeled "Step 2," and lacks validation checkpoints before destructive proxy requests. Structure is good for a single-file skill with no external bundles.
Suggestions
Remove the introductory paragraph explaining what Replicate is and the vague "Replicate Overview" filler; assume Claude knows the platform.
Label the post-connection steps explicitly (e.g. "## Step 2: Discover and run actions") so the "skip to Step 2" reference resolves.
Add a validation/verification checkpoint before destructive proxy requests (POST/PUT/DELETE), e.g. confirming the target id or running a dry-run GET first.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is efficient code blocks and a flag table, but the opening paragraph explaining what Replicate is ("a platform for running machine learning models in the cloud...") and the thin "Replicate Overview" bullet filler ("Use action names and parameters as needed") are unnecessary explanation Claude already knows, matching the score-3 anchor of mostly efficient with some over-explanation. | 3 / 5 |
Actionability | The body provides copy-paste-ready commands for install, login, connection ensure, action list/run, and request, plus a full flag table, but placeholders (CONNECTION_ID, QUERY, actionId) and a redundant second `action list` example leave minor gaps, matching the score-4 anchor of mostly executable guidance with minor gaps. | 4 / 5 |
Workflow Clarity | A rough sequence exists (install → login → connection ensure → poll state → search → run) with state checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED), but the "skip to Step 2" reference has no labeled Step 2 and there are no validation/verification steps before destructive proxy operations (POST/DELETE), which caps the score at 3 per the destructive-operation guideline. | 3 / 5 |
Progressive Disclosure | The content is a single well-organized file with clear section headers and no nested or buried references (no bundle files exist), but minor organization gaps like the redundant action-list sections and the thin Overview section keep it just below the score-5 anchor. | 4 / 5 |
Total | 14 / 20 Passed |