Content
75%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-structured overview skill: lean body, executable keyless commands, explicit decision gates and a done-when checklist, and a clean one-level-deep reference set that all exists. Weaknesses are mild — some redundancy across example blocks, instruction steps that inventory fields rather than procedures, no final verification loop, and cross-bundle links that don't resolve within this skill's directory.
Suggestions
Collapse the five scattered example-prompt code blocks (Quick Start plus the four under Advanced Analysis Types) into one 'Example prompts' section to remove redundancy and cut tokens.
Add a final verification step to the workflow (e.g. before writing the deliverable, confirm every table cell is labeled Measured/User-provided/Estimated/N/A and every strength/weakness cites a named competitor) to close the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no concept explanations, no library tutorials — e.g. "Label every metric Measured (tool/export), User-provided, or Estimated (model inference)". It is not a 5 because of mild redundancy: five standalone prompt-style code blocks under Quick Start / Advanced Analysis Types overlap with the instructions, and content-gap-analysis is linked three separate times. | 4 / 5 |
Actionability | Concrete, executable guidance is present: exact keyless commands ("python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py\" scrape <competitor-url>", "map <competitor-domain> --limit 500", "search <brand> --tbs qdr:m"), an exact save path, and a per-step data checklist. It stays below 5 because several instruction steps are field inventories to 'review'/'evaluate' (e.g. "Audit Content Strategy — review content volume, top performers, publishing patterns") rather than executable procedures, deferring specifics to the references. | 4 / 5 |
Workflow Clarity | A clear 8-step sequence is framed by explicit checkpoints: "Stop and ask — when the competitor set cannot be established", a "Done when" completion checklist (3-5 competitors in one table, every claim citing evidence, closing plan), and a labeling/quality-bar rule ("never present an estimate as measured"). Not a 5 because there is no verify-before-deliver feedback loop — nothing instructs re-checking tool data or table completeness if a metric turns out missing mid-analysis. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview: all four bundle files (references/analysis-templates.md, battlecard-template.md, positioning-frameworks.md, example-report.md) are real, one level deep, and clearly signaled both inline and in a Reference Materials index. It misses 5 because several referenced paths — ../../../references/skill-contract.md, ../../../CONNECTORS.md, ../../../SECURITY.md, ../../../scripts/connectors/README.md, ../../../references/platforms/youtube.md, ../content-gap-analysis/SKILL.md — do not exist inside the evaluated bundle, leaving minor navigation gaps relative to the actual file structure. | 4 / 5 |
Total | 16 / 20 Passed |