Content
67%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 delivers concrete, well-sequenced Instagram workflows with real validation checkpoints and a useful quick-reference table. Its main weaknesses are duplicated pitfall content and an empty 'When to Use' section that add tokens without value.
Suggestions
Remove the redundant 'Known Pitfalls' section or fold it into the per-workflow 'Pitfalls' so each pitfall appears once, cutting token cost.
Replace the vacuous 'When to Use' line with concrete trigger conditions (e.g. publishing posts/carousels, pulling insights, checking publishing limits) or delete the section.
Add an explicit error-recovery loop for publishing failures (e.g. on non-FINISHED status or 429, poll/back off and retry) to strengthen workflow_clarity for batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and avoids explaining concepts Claude already knows, but the 'Known Pitfalls' section duplicates per-workflow pitfalls (public URLs, 25-post limit, Business/Creator requirement) and the 'When to Use' section is vacuous, so it could be tightened. | 3 / 5 |
Actionability | Concrete tool slugs, ordered tool sequences, and key parameters are given for each workflow; exact schemas are intentionally deferred to RUBE_SEARCH_TOOLS, leaving only minor gaps. | 4 / 5 |
Workflow Clarity | Workflows are clearly sequenced with [Required]/[Optional] markers and validation checkpoints (FINISHED status polling, publishing-limit checks, ACTIVE connection confirmation), but explicit validate-fix-retry feedback loops are absent. | 4 / 5 |
Progressive Disclosure | Well-organized into Prerequisites, Setup, Core Workflows, Common Patterns, Known Pitfalls, and Quick Reference with no nested or broken references; no bundle files exist, and the single-file structure is appropriate with only minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |