Content
71%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, actionable workflow with concrete commands and clear sequencing. The main gaps are the missing 'run_actor.js' script in the bundle (the workflow's central dependency) and the absence of a concrete input example or post-run validation step.
Suggestions
Ship the referenced run_actor.js script inside the skill's scripts/ directory (and fix the path so it resolves within the bundle), since every execution step depends on it.
Add one concrete example of a JSON_INPUT value (e.g., for the Instagram profile scraper) so the --input argument is copy-paste ready.
Insert a validation checkpoint between Step 4 and Step 5 — confirm the run succeeded and output is non-empty before summarizing results.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — a selection table, ready-to-run commands, and short step descriptions with almost no explanation of concepts Claude already knows. Minor trimmable cruft remains (the odd "(No need to check it upfront)" note and the vague "Based on character of use case"), so it fits 'efficient; minor instances of over-explanation' rather than the fully lean score-5 anchor. | 4 / 5 |
Actionability | Guidance is mostly executable: concrete bash commands for schema fetching and three ready-to-run script invocations with flags, plus a remediation list per error. It stops short of score 5 because placeholders like 'JSON_INPUT' lack a concrete example input, so the user must construct the argument without a template. | 4 / 5 |
Workflow Clarity | A clear 5-step sequenced workflow with a copy-trackable checklist, an explicit decision table for Step 1, and an error-handling section covering failure recovery — matching 'clear sequence with most checkpoints present'. It is not 5 because there is no validation step between running the Actor and summarizing (e.g., verifying the run succeeded or output is non-empty before reporting), and not 3 because the operations are non-destructive and remediation guidance is present. | 4 / 5 |
Progressive Disclosure | The body relies on ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js, but no scripts/ (or references/) directory exists in the bundle — a dangling reference that leaves the core execution step unverifiable. All content (including the 15-actor table) is inlined in SKILL.md with no external references, fitting 'some structure but could be better organized; references present but not clearly signaled'. | 3 / 5 |
Total | 15 / 20 Passed |