Content
81%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 well-structured, highly actionable debugging skill with an exemplary triage workflow, explicit stop conditions, and executable commands and code. The main improvement levers are deduplicating the per-step reporting reminders and moving the logging recipes toward a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — no explanation of what logs or DevTools are — and the code examples earn their tokens. Minor redundancy costs the top score: the "Tell the user: ... → share ... → explain next step" reminder is repeated at the end of all four triage sections after the Reporting Contract already established the pattern. | 4 / 5 |
Actionability | Mostly executable: concrete commands (`vercel logs --follow`, `vercel workflow runs list`, `vercel workflow runs get <run-id>`, `vercel inspect <deployment-url>`, `vercel ls`) and two copy-paste-ready TypeScript logging examples. Not a 5 because the browser-verification section is directional ("Check the Network tab for failed requests") with no concrete command, and "agent-browser" is invoked without usage. | 4 / 5 |
Workflow Clarity | Clear 1→4 triage sequence with explicit checkpoints (the three-part Reporting Contract applied at every step), an explicit Stop Condition section, and feedback loops: "If no logs exist: This is the problem. Add logging before continuing" and "Two consecutive triage steps produce no signal — ... ask the user for more context". This matches anchor 5; the stop rules give error-recovery guidance for the no-signal case. | 5 / 5 |
Progressive Disclosure | Good structure with clear section headers, and the cross-reference to the observability and workflow skills is clearly signaled and one level deep. Not a 5 because the skill is fully monolithic (no bundle files exist), and the ~110-line body — particularly the Add Logging code block and Common Hang Causes list — is borderline content that could be split into a reference file for a leaner overview. | 4 / 5 |
Total | 17 / 20 Passed |