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.
A well-organized, concise command reference with concrete slash-command examples, clear phase sequencing, and useful decision tables. The main defects are that the documented workflow depends on script paths absent from this bundle and there is no explicit validation/re-audit step after optimization.
Suggestions
Ship the referenced scripts (aeo_audit.py, aeo_optimizer.py, citation_tracker.py) inside the skill's scripts/ directory and update the workflow paths accordingly, or state how to resolve the marketing-skill/... paths.
Add a validation step after optimize, e.g. re-run the audit on the -aeo.md variant to confirm the composite score clears the industry threshold before publishing.
Move the version stamp (2.7.3) into a changelog or de-emphasize it so the footer carries only actionable metadata.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is tight and table-driven — mode definitions, intake questions, and industry thresholds are all compressed into scannable structures with almost no padding. Minor trims remain: the YMYL gloss "('Your Money or Your Life')" explains something Claude knows, and the footer's "Version: 2.7.3" is time-sensitive metadata outside any deprecated section, so it is not the fully lean anchor 5. | 4 / 5 |
Actionability | Slash-command examples are concrete and copy-paste ready ("/cs:aeo audit --input post.md --industry saas"), but the Workflow section's executable steps ("python3 marketing-skill/skills/aeo/scripts/aeo_audit.py --input <file> --industry <industry>") point at script paths that do not exist in this skill's bundle and use unfilled placeholders. The documented workflow therefore cannot be executed as written from this skill, which fits anchor 3 (concrete but incomplete) better than anchor 4's mostly-executable guidance. | 3 / 5 |
Workflow Clarity | Phases 1-5 are clearly sequenced with per-phase expected outputs ("# → composite score 0-100 + top fixes"), an explicit conditional gate ("if audit < industry threshold" backed by the threshold table), and a manual review checkpoint before publish. It falls short of anchor 5 because there is no explicit verification step (e.g., re-audit the optimized variant) and no error-recovery loop; it exceeds anchor 3 because most checkpoints are explicit rather than implicit. | 4 / 5 |
Progressive Disclosure | The single-file body is well organized with clear sections (When To Run / Not To Run, Actions, Workflow, thresholds, anti-patterns) and external pointers are gathered in a clearly signaled, one-level-deep Related section. It is not anchor 5 because the referenced paths (agents/marketing/cs-aeo.md, marketing-skill/skills/aeo/SKILL.md, the workflow scripts) are not present in the bundle, leaving navigation to files that don't resolve from this skill. | 4 / 5 |
Total | 15 / 20 Passed |