Content
64%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides solid actionable guidance with executable commands and a well-structured Actor selection table, making it practical for market research tasks. Its main weaknesses are the lack of validation checkpoints in the workflow (e.g., verifying schema fetch results or validating inputs before running actors) and some verbosity in the Actor table and boilerplate limitations section. The absence of bundle files makes it impossible to verify referenced script paths.
Suggestions
Add a validation step after fetching the Actor schema (Step 2) to verify the response contains expected fields before proceeding, and add input validation before running the actor in Step 4.
Move the Actor lookup table to a separate reference file (e.g., ACTORS.md) and keep only a brief summary in SKILL.md to improve progressive disclosure and reduce inline bulk.
Remove the generic Limitations section or replace it with skill-specific constraints (e.g., rate limits, data freshness caveats, platform-specific quirks).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary elements like the large Actor table that could be more compact, and the Limitations section contains generic boilerplate that doesn't add value. The error handling section is appropriately concise. | 2 / 3 |
Actionability | Provides fully executable bash commands for each step, concrete Actor IDs in a lookup table, specific CLI flags and options, and clear input/output patterns. The commands are copy-paste ready with clear placeholder substitution. | 3 / 3 |
Workflow Clarity | The workflow has a clear 5-step sequence with a progress checklist, but lacks validation checkpoints. There's no step to verify the Actor schema was fetched correctly, no validation of the JSON input before running, and no feedback loop for handling partial or unexpected results. | 2 / 3 |
Progressive Disclosure | The skill references `${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js` but no bundle files are provided to verify this exists. The content is somewhat monolithic with the large Actor table inline rather than in a reference file. However, the section structure is logical and navigable. | 2 / 3 |
Total | 9 / 12 Passed |