Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, actionable audit skill with clear navigation to four real reference files and explicit validation checkpoints. The only meaningful weakness is mild repetition of the sibling-function guidance.
Suggestions
Consolidate the sibling-function guidance: state the rule once (in step 4) and reference it from step 3 and the checklist rather than restating it three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is substantive and free of basic-concept padding, but the sibling-function guidance is restated across step 3, step 4, and the verify checklist, so it could be tightened. Not a 3 because some repetition remains. | 2 / 3 |
Actionability | It gives concrete commands ('npx convex insights --details', 'npx -y convex@latest insights --details'), specific APIs to trace (ctx.db.get/query/patch/replace/insert, useQuery/usePaginatedQuery/useMutation), a symptom-to-reference routing table, and a copy-ready verification checklist. | 3 / 3 |
Workflow Clarity | A clearly sequenced 5-step workflow ends with an explicit 'Verify before finishing' checklist, and 'Escalate Larger Fixes' adds a stop-and-confirm checkpoint before invasive changes, covering the feedback loop for risky operations. | 3 / 3 |
Progressive Disclosure | SKILL.md is a concise overview with a signal-routing table and a Reference Files section pointing one level deep to four real, verified reference files (hot-path-rules, occ-conflicts, subscription-cost, function-budget), each with a one-line description. | 3 / 3 |
Total | 11 / 12 Passed |