Content
50%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 provides a clear, actionable structure for querying competitor ads via two named tools, but is undermined by a referenced analysis script that does not exist in the bundle, duplicated workflow sections, a batch-comparison workflow lacking any validation steps, and a promotional footer that spends tokens on marketing rather than instruction.
Suggestions
Fix the broken bundle reference: either include `scripts/analyze-competitor.py` in the bundle or remove the "Automated Analysis" section, since Claude will currently attempt to run a script that does not exist.
Add a validation checkpoint to the workflows — e.g., confirm the platform ID returned by `get_meta_platform_id` matches the intended brand before fetching ads, and verify each result when batch-comparing multiple competitors.
Merge the duplicative "Find a Competitor's Ads" and "Analyze Competitor Strategy" sections into one workflow, and move the Synter promotional footer out of SKILL.md to save context-window tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The instructional core is lean (tool list, numbered steps, example prompts with no over-explanation of known concepts), but "### Analyze Competitor Strategy" substantially duplicates the "Find a Competitor's Ads" workflow, and the ~10-line "About this skill" footer with Synter promotional links and UTM-tagged URLs is pure advertising padding that earns no tokens. This is more than 'minor instances' (so not 4) but the core guidance itself is not verbose or padded with explanations (so not 2). | 3 / 5 |
Actionability | There is concrete guidance — named MCP tools (`get_meta_platform_id`, `get_meta_ads`), a sequenced call pattern, and a bash command `python scripts/analyze-competitor.py "BrandName"` — but key details are missing: the referenced script does not exist in the bundle (no `scripts/` directory), so the command is not executable as written, and the batch claim ("Pass an array of brand names") is stated without syntax or constraints. Concrete but incomplete matches anchor 3; not 2 because specific tool names and a runnable invocation pattern are given. | 3 / 5 |
Workflow Clarity | "Find a Competitor's Ads" lists a clear 3-step sequence (get platform ID → fetch ads → analyze patterns), but no validation checkpoints exist anywhere — no step confirms the platform ID matches the intended brand before fetching ads, and none verifies batch results. The "Compare Multiple Competitors" workflow is a batch operation without validation or feedback loops, which per the rubric caps workflow clarity at 3; anchor 3 ('steps listed but validation gaps') is the best fit. | 3 / 5 |
Progressive Disclosure | Sections are clearly organized and the body is short (~75 lines), but the only external reference — `scripts/analyze-competitor.py` under "Automated Analysis" — is missing from the bundle entirely (no scripts/ directory exists), so navigating to the detailed material fails. A broken primary reference is a substantive organization gap beyond the 'minor organization gaps' of anchor 4, while the good sectioning and absence of inlined overflow content keeps it above anchor 2. | 3 / 5 |
Total | 12 / 20 Passed |