Content
38%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a comprehensive but severely bloated reference document that reads more like a web performance tutorial than a concise skill for Claude. While it contains genuinely useful, executable code examples (image optimization scripts, code splitting patterns, HTML picture elements), the massive volume of content—including explanations of well-known concepts, extensive do/don't lists, tool catalogs, and resource links—wastes significant token budget. The content would benefit enormously from being split into a lean overview with references to detailed sub-files.
Suggestions
Reduce the main file to ~80 lines: a brief workflow overview, one concise example, and references to separate files for image optimization, bundle optimization, and CWV details.
Remove all explanatory content Claude already knows: what Core Web Vitals are, what CDNs do, what lazy loading means, the 'When to Use This Skill' section, and the do/don't best practices lists.
Split the three large examples into separate bundle files (e.g., EXAMPLES_CWV.md, EXAMPLES_BUNDLE.md, EXAMPLES_IMAGES.md) and reference them from the main skill.
Add explicit validation commands to the workflow (e.g., 'Run `npx lighthouse URL --output=json > before.json`, implement changes, then run again and diff the scores') instead of vague 'Re-run Lighthouse audits' instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~400+ lines. Extensively explains concepts Claude already knows (what Core Web Vitals are, what lazy loading is, what a CDN does). Lists of tools, best practices do/don't lists, and 'When to Use This Skill' sections are all padding. The 'Additional Resources' and 'Related Skills' sections add more bloat. Nearly every section over-explains rather than providing only novel, actionable information. | 1 / 5 |
Actionability | The examples contain concrete, executable code snippets (sharp image optimization script, webpack config, HTML picture elements, Next.js dynamic imports). Code is mostly copy-paste ready. However, some guidance remains high-level (e.g., 'Use CDN for faster delivery', 'Optimize database queries') without concrete implementation details. | 4 / 5 |
Workflow Clarity | The 5-step workflow (Measure → Identify → Prioritize → Implement → Verify) is listed but each step is vague bullet points rather than concrete commands. The verification step says 'Re-run Lighthouse audits' and 'Compare before/after metrics' without specifying how to capture and compare baselines. The examples show before/after results but don't demonstrate an actual validation feedback loop with error recovery. | 3 / 5 |
Progressive Disclosure | No bundle files exist, yet the content is a monolithic wall of 400+ lines with three massive inline examples, full checklists, tool lists, and resource links all in one file. The image optimization script, bundle analysis examples, and detailed CWV examples should be in separate referenced files. References to other skills exist but the content itself desperately needs splitting. | 2 / 5 |
Total | 10 / 20 Passed |