Content
42%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides excellent actionability with concrete, executable commands and a clear workflow structure. However, it severely suffers from poor progressive disclosure and conciseness—the massive inline Actor lookup tables (which are pure reference data) dominate the file and bury the actual instructional content. Moving reference tables to separate files and integrating validation into the workflow would dramatically improve this skill.
Suggestions
Move all Actor lookup tables (Instagram, Facebook, TikTok, YouTube, Google Maps, Other, use-case mapping, multi-actor workflows) to a separate reference file like `ACTORS.md` and link to it from SKILL.md.
Add a validation checkpoint after Step 4 (e.g., check exit code, verify output file exists and is non-empty, handle the case where 0 results are returned) before proceeding to Step 5.
Integrate error handling into the workflow steps rather than listing it as a separate section—e.g., after Step 4, include 'If run fails, check error output and see Error Handling below.'
Reduce the SKILL.md to the workflow steps, prerequisites, and brief Actor selection guidance (e.g., 'See [ACTORS.md](ACTORS.md) for the full catalog of 55+ Actors by platform and use case').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose, with massive Actor lookup tables (55+ actors across ~100 lines of tables) that could be offloaded to a reference file. The use-case mapping tables and multi-actor workflow tables add further bulk. Most of this content is reference data, not instructional content, and bloats the SKILL.md significantly. | 1 / 3 |
Actionability | The skill provides fully executable bash commands for every step—fetching schemas, searching actors, and running scripts with exact CLI syntax for CSV, JSON, and quick-answer modes. Commands are copy-paste ready with clear placeholder substitution. | 3 / 3 |
Workflow Clarity | The 5-step workflow is clearly sequenced with a progress checklist, but there are no validation checkpoints between steps. After running the script (Step 4), there's no explicit error-checking or validation step before summarizing results—the error handling section is separate and not integrated into the workflow flow. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with all 55+ Actor tables inline. The Actor reference tables, use-case mappings, and multi-actor workflows should be in separate reference files, with SKILL.md providing a concise overview and links. The content that matters (the workflow steps) is buried among hundreds of lines of lookup tables. | 1 / 3 |
Total | 7 / 12 Passed |