Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A thorough, highly actionable multi-step workflow with clear sequencing and checkpoints, but it is monolithic with no bundle files and carries a dangling cross-reference plus a redundant conceptual closing section that hurts token efficiency.
Suggestions
Move the three asset-type templates (Definitive Guide, Benchmark Report, Comparison Hub) into a references file (e.g. references/asset-templates.md) and link to it from Step 4, keeping SKILL.md a lean overview.
Delete or fold the closing "What makes a source authoritative to AI models" section into Step 2's audit criteria to remove the conceptual restatement and redundancy.
Resolve the `prompt-gap-to-publish` reference — either ship that guidance as a real bundle file or remove the pointer so the body references only files that exist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and instructional, but the closing "What makes a source authoritative to AI models" section restates concepts and overlaps heavily with the Step 2 audit criteria (answer structure, data, comprehensiveness, freshness, authority), adding redundant conceptual padding Claude could largely infer. | 2 / 3 |
Actionability | Highly actionable for an instruction-only skill: names specific MCP tools (list_ai_visibility_org_brands, get_ai_visibility_sources, web_fetch, create_documents_from_markdown, create_entry, etc.), concrete fields, per-CMS draft parameters, and detailed asset templates with section counts and meta-field specs — copy-paste ready guidance. | 3 / 3 |
Workflow Clarity | A clearly sequenced Step 0–5 flow with explicit checkpoints: Step 0 prevents a copy-paste dead end, Step 3 says "Wait for their pick", and Step 5 confirms the draft push. No destructive/batch operations are involved (CMS pushes are drafts), so the absence of validate→fix loops does not cap the score. | 3 / 3 |
Progressive Disclosure | Sections are well-organized, but the skill is monolithic (~240 lines) with long inline asset-type templates that could live in reference files, and it cites `prompt-gap-to-publish` which has no corresponding file in references/, scripts/, or assets/ — an unverifiable/dangling reference against an empty bundle. | 2 / 3 |
Total | 10 / 12 Passed |