Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable skill with a clear multi-step workflow and strong validation checkpoints. Its main weaknesses are verbosity (the motivational 'Why simulate' section and some explanatory text Claude doesn't need) and the monolithic structure that could benefit from splitting CMS-specific details and scoring rubrics into separate reference files. The workflow design is excellent, with explicit decision points and feedback loops throughout.
Suggestions
Remove or drastically shorten the 'Why simulate before publishing' section — Claude doesn't need motivation to follow instructions, and this adds ~15 lines of pure rationale.
Extract CMS-specific push instructions (Step 7 details) into a separate reference file like CMS_PUSH_REFERENCE.md to reduce the main skill's length and improve progressive disclosure.
Trim explanatory phrases like 'This is the ground truth — it's exactly what AI models currently say' and 'Small rewrites don't help you learn anything; genuine alternatives do' which explain reasoning Claude doesn't need.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~300 lines) and includes some unnecessary explanation, particularly the 'Why simulate before publishing' section at the end which explains concepts Claude doesn't need motivation for. The CMS table and per-CMS instructions are useful but could be more compact. Some sections like Step 2's extraction bullet points explain analytical concepts Claude already understands. | 2 / 3 |
Actionability | The skill provides highly concrete, executable guidance throughout: specific API tool names to call (e.g., `get_ai_visibility_prompts`, `create_documents_from_markdown`), exact scoring rubrics with 1-5 scales, specific CMS field mappings, example table output for scoring, and exact phrasing for user-facing messages. Every step has clear, copy-paste-ready instructions. | 3 / 3 |
Workflow Clarity | The 8-step workflow (Steps 0-7) is clearly sequenced with explicit checkpoints: Step 0 discovers CMS before starting, Step 5 is an explicit simulation checkpoint where the user decides whether to proceed or pause, and the workflow includes feedback loops (e.g., 'If the simulation comes back and changes their mind... generate the revised variant in full before pushing'). Validation is built into the scoring step and the simulate-before-publish checkpoint. | 3 / 3 |
Progressive Disclosure | The content is entirely monolithic — all instructions are inline in a single long file with no references to supporting files. The CMS-specific instructions, variant differentiation axes, and scoring rubric could be split into separate reference files. There are references to other skills ('prompt-gap-to-publish', 'competitor-prompt-hijacker') but no structured navigation to supporting materials. | 2 / 3 |
Total | 10 / 12 Passed |