Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced verification workflow with executable commands, explicit validation checkpoints, and a bounded retry loop. The only notable improvements are deduplicating repeated eval snippets and moving the specialized server-log correlation material into a reference file.
Suggestions
Deduplicate the repeated eval checks (window.__consoleErrors and the error-overlay selector appear in both the Quick Verification Flow and the Diagnosing sections) by referencing one canonical snippet.
Move the server-side correlation section (vercel logs, npx workflow inspect/health, and the correlation table) into a references/ file for stuck-page diagnosis, keeping SKILL.md focused on the core verification flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — terse command blocks, a compact checklist, and a symptom-to-cause table with no tutorials on concepts Claude already knows. It misses the 5 anchor due to small redundancies: the window.__consoleErrors eval and the error-overlay eval each appear twice, and phrases like "the browser is only half the story" are slight padding. | 4 / 5 |
Actionability | Every step is copy-paste executable: agent-browser commands, concrete selectors ([data-nextjs-dialog], .vite-error-overlay, #webpack-dev-server-client-overlay), runnable eval expressions, and specific fixes in the correlation table (vercel link && vercel env pull, increasing maxDuration). This fully matches the top anchor. | 5 / 5 |
Workflow Clarity | The sequence is explicit (open → wait for networkidle → screenshot → error check → snapshot), backed by a 6-item verification checklist, a numbered failure path, a bounded retry loop ("max 2 retry cycles to avoid infinite loops"), and a re-verify procedure with feedback recovery. Matches the 5 anchor with explicit validation checkpoints. | 5 / 5 |
Progressive Disclosure | The single-file body has clear, well-ordered sections and no dangling references (no bundle files exist). It is not a 5 because the server-side correlation deep-dive (vercel logs, npx workflow inspect/health) is niche troubleshooting that would sit more appropriately in a separate reference file. | 4 / 5 |
Total | 18 / 20 Passed |