Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-sequenced, highly actionable workflow with concrete tool names, field mappings, and confirmation checkpoints at the risky publish step. Its main weaknesses are verbosity in the Step 0 CMS-discovery dialogs and a monolithic single-file structure that underuses progressive disclosure for a skill of this length.
Suggestions
Condense Step 0's per-CMS setup blocks into a compact table or move the full setup dialogs into a references/cms-setup.md file, keeping only a short pointer inline.
Split the per-CMS field-mapping details in Step 6 into a reference file (e.g. references/cms-field-mappings.md) and link to it, so the main SKILL.md stays a lean overview.
Tighten filler lines such as 'This saves the user from a copy-paste dead end at the finish line' and the repeated 'Want me to continue finding your content gaps...?' phrasings to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining concepts Claude already knows, but Step 0's seven per-CMS quoted setup dialogs and repeated confirm phrasings ('Want me to continue...?') could be tightened, and lines like 'This saves the user from a copy-paste dead end at the finish line' add mild padding. It is not maximally lean, so it does not reach the score-3 anchor. | 2 / 3 |
Actionability | Provides concrete tool names (list_ai_visibility_org_brands, get_ai_visibility_topics, wp_create_post, create_entry), explicit field mappings (fields.title, status: draft, state: DRAFT), quantified heuristics (relevancy > 60% and visibility < 40%), and character limits. Though instruction-only with no code, the guidance is specific and copy-paste ready, which the rubric rewards. | 3 / 3 |
Workflow Clarity | Steps 0–6 are clearly sequenced with explicit confirmation checkpoints at the risky publish step ('Ready to push this to [CMS] as a draft?') and a guard ('never published without explicit instruction'). The sequence and checkpoints are explicit rather than implied, placing it above the score-2 anchor. | 3 / 3 |
Progressive Disclosure | Sections are well-organized with clear headers and tables, but the skill is a monolithic ~250-line single file with no bundle references, and the lengthy per-CMS setup details in Step 0 and field mappings in Step 6 are content that could plausibly live in a separate reference file. It is well structured rather than a wall of text, so it is above 1, but lacks the one-level-deep references needed for a 3. | 2 / 3 |
Total | 10 / 12 Passed |