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 is well structured with concrete, fully-flagged commands and useful reference tables, but it is undermined by referencing scripts that do not exist in the bundle, a batch-modification workflow with no validation checkpoints, and a promotional footer that wastes tokens. These issues leave it at the midpoint across all content dimensions.
Suggestions
Ship the referenced scripts (scripts/research-keywords.py, scripts/add-keywords.py, scripts/keyword-report.py) in the bundle, or remove the references and describe the underlying API calls directly in SKILL.md.
Add validation checkpoints to the workflow: before adding, check candidates against negative keyword lists; after running add-keywords.py, verify the additions landed in the intended ad groups before proceeding to the report step.
Remove the promotional 'About this skill' footer (Synter links, UTM tags, social links) — it spends ~10 lines of context on marketing content that contributes nothing to task execution.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Core instructional sections are tight (command blocks, filter table, category table), but the promotional "About this skill" footer — "Want this skill (and 40+ more) running on autopilot against your live ad accounts? Try Synter" with UTM-tagged marketing links — spends roughly ten lines on non-instructional content. This is more than the minor trimming an anchor-4 score allows, though the rest is too efficient to fall to 2. | 3 / 5 |
Actionability | Commands are concrete and fully parameterized ("python3 scripts/research-keywords.py --seeds ... --max-competition 50 --min-volume 100 --max-cpc 25") with realistic example values, but all three referenced scripts (research-keywords.py, add-keywords.py, keyword-report.py) are absent from the bundle, so nothing is actually executable. Missing the entire scripts directory is a key detail rather than a minor gap, which rules out 4. | 3 / 5 |
Workflow Clarity | The three steps (research → add → report) are clearly sequenced with headers and commands, but adding keywords to live ad groups is a batch operation and the workflow has no validation checkpoint — the negative-keyword conflict check appears only as a best-practices bullet, not as a step, and there is no post-add verification. The batch-operation cap of 3 applies, so the clear sequence cannot lift it to 4. | 3 / 5 |
Progressive Disclosure | Sections are well organized and script references are clearly signaled within the workflow steps, but every referenced bundle path (scripts/*.py) is a dangling reference — no scripts/ directory exists. The claimed bundle structure is broken, which blocks the anchor-4 'references mostly clear' placement despite good in-file organization. | 3 / 5 |
Total | 12 / 20 Passed |