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 tightly structured, highly actionable debugging skill with a clear triage workflow and real feedback checkpoints. It is mostly token-efficient; the main lever is collapsing the repeated reporting-contract template and extracting the larger code/list blocks into reference files.
Suggestions
Collapse the four repeated "Tell the user: ... → share ... → explain next step" lines into a single stated contract referenced once, instead of restating it per triage step.
Move the Common Hang Causes list and the Add Logging code examples into a separate reference file (e.g. references/debugging-patterns.md) and link to it from the body to improve progressive disclosure.
Trim editorializing sentences like "The user is already frustrated — silence makes it worse" and "you cannot debug what you cannot see" that restate what the workflow already implies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence without explaining basics, but the repeated "Tell the user: ... → share ... → explain next step" template across four sections and editorializing lines ("The user is already frustrated — silence makes it worse") could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready commands (vercel logs --follow, vercel workflow runs list, vercel inspect <deployment-url>, vercel ls) and complete TypeScript logging examples covering the common cases. | 5 / 5 |
Workflow Clarity | Clear sequenced triage (runtime logs → workflow → browser → deploy/env) with an explicit stop condition and a genuine feedback loop (two empty steps triggers escalation to the user), plus an Add-Logging recovery path. | 5 / 5 |
Progressive Disclosure | Well-organized into labeled sections with clearly signaled one-level cross-references to the observability and workflow skills; minor gaps where the Common Hang Causes list and Add Logging code could be split out, but no nested references. | 4 / 5 |
Total | 18 / 20 Passed |