Content
68%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 well-structured and actionable with concrete commands and a useful actor-mapping table, but the batch workflow lacks an explicit validation checkpoint before execution, and a small amount of redundancy with the description slightly reduces conciseness.
Suggestions
Insert a validation checkpoint between Step 2 and Step 4 (e.g., 'Verify required input parameters against the fetched schema before running') to lift workflow_clarity above the batch cap of 3.
Remove the redundant intro line under the '# Content Analytics' heading since it restates the frontmatter description.
Provide one fully concrete example input (a populated --input JSON for a common actor) to move actionability toward copy-paste-ready 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | An efficient actor-selection table and concrete commands respect the token budget, though the opening line ('Track and analyze content performance using Apify Actors...') duplicates the frontmatter description and could be trimmed. | 4 / 5 |
Actionability | Provides executable bash commands with specific actor IDs and three output formats, but placeholders like ACTOR_ID and JSON_INPUT require user substitution, leaving minor gaps versus copy-paste-ready 5-anchor coverage. | 4 / 5 |
Workflow Clarity | A clear 5-step sequence with a progress checklist exists, but this batch data-collection workflow has no validation checkpoint between fetching the Actor schema (Step 2) and running the script (Step 4), capping workflow clarity at 3 per the batch-operation guideline. | 3 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections with a clearly signaled script reference (${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js); the 17-row actor table is large but appropriately serves discovery, leaving only minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |