Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-structured skill body with clear workflows, validation checkpoints, and exemplary one-level-deep reference disclosure; its main weakness is redundancy that inflates token usage without adding capability.
Suggestions
Consolidate the repeated 'Always check pwd before running scripts' warning and working-directory protocol into a single Execution Protocol section, removing the duplicate CRITICAL callouts in Quick Start and Available Scripts.
Trim the Troubleshooting section to a concise error-to-fix mapping and remove details already covered in the Installation steps (e.g., the libnss3 apt-get command duplicates install-deps.sh guidance).
Consider moving the long Troubleshooting block into a ./references/troubleshooting.md file so the main SKILL.md stays a lean overview while keeping the detail one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and operational, but repeats the 'Always check pwd' warning (lines 13 and 68) and restates working-directory verification across Quick Start, Available Scripts, and Execution Protocol, while the verbose Troubleshooting section overlaps the Install section — matching the 'could be tightened' anchor rather than the every-token-earns-its-place profile of a 3. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands such as 'node screenshot.js --url https://example.com --output page.png --max-size 3' and jq pipelines over JSON output, with concrete flags and examples matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | The Execution Protocol gives a numbered Working Directory Verification, an Output Validation checkpoint ('ls -lh', Read tool, 'success:true' check), and an Error Recovery feedback loop (selector fails -> snapshot.js -> retry XPath), plus a Common Mistakes checklist — clear sequence with explicit validation and feedback loops. | 3 / 3 |
Progressive Disclosure | A 'Reference Documentation' section signals three one-level-deep references (cdp-domains.md, puppeteer-reference.md, performance-guide.md, all verified to exist) with descriptions, and points to ./scripts/README.md for complete options; deep material is appropriately externalized, matching the clear-overview-with-signaled-references anchor. | 3 / 3 |
Total | 11 / 12 Passed |