Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, battle-tested skill that encodes real lessons learned from production failures. The workflow is exceptionally clear with proper validation gates, the actionability is high with concrete commands and schemas, and the progressive disclosure is well-structured across reference files. Minor weaknesses include some redundancy in planning warnings, the presence of git merge conflict markers at the bottom, and a few sections that could be tightened for conciseness.
Suggestions
Remove the git merge conflict markers (<<<<<<< HEAD / ======= / >>>>>>>) at the bottom of the file — these are literal noise that could confuse execution.
Consolidate the repeated 'plan before coding' warnings (appears in Workflow step 2, Activation section, and closing paragraph) into a single prominent callout to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~300 lines) but most content is genuinely novel domain knowledge (mode differences, YAML structure, QA checklist, deployment paths, lessons learned). Some sections could be tightened — e.g., the repeated warnings about planning-first and the Citi engagement anecdotes appear multiple times. The git merge conflict markers at the bottom are noise. However, it largely avoids explaining things Claude already knows. | 2 / 3 |
Actionability | Highly actionable throughout: concrete bash commands for building and verification, specific YAML schema with required fields, exact file paths for reference implementations, a detailed QA checklist with specific rules (no em dashes, no contractions, exactly 3 next steps), mode-specific starter scripts, and precise dimensions/file size targets. The guidance is copy-paste ready and leaves little ambiguity. | 3 / 3 |
Workflow Clarity | The 9-step workflow is clearly sequenced with explicit validation checkpoints: mechanical QA with multiple verification modes (overlaps, repetition, titles, visual render), a three-pass polish process, a content rules checklist, and a strong gate ('never declare done without visual verification'). The feedback loop is explicit — fix and re-validate. The brief-before-YAML gate prevents the documented failure mode of premature coding. | 3 / 3 |
Progressive Disclosure | Excellent progressive disclosure: the main skill provides a clear overview and workflow, then points to 8 well-organized reference files (narrative-planning, polish-pass, architecture, page-patterns, brand-standards, content-rules, qa-process, failure-modes) — all one level deep with clear descriptions. Scripts are listed separately. The inline content is appropriately scoped to what's needed for the overview. | 3 / 3 |
Total | 11 / 12 Passed |