Content
92%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.
An exemplary lean, high-signal skill body: a numbered procedure with quantitative proof thresholds, a concrete root-cause checklist, and crisp exit criteria, with zero padding. The only improvement would be specifying how to execute the measurements (e.g., a k6 snippet or harness command) to make the guidance fully copy-paste executable.
Suggestions
Add a minimal executable example of the measurement harness (e.g., a k6 command or loop snippet) so the 'failure rate over N≥20 runs' and '0 failures in ≥1,000 calls' steps are copy-paste runnable.
Briefly state the recovery loop when step 4 proof fails (e.g., 'if any proof fails, return to step 2'), making the implicit fix-until-proven cycle explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~20-line body is lean and assumes competence: step 2's cause list ("shared mutable state, counters, missing awaits, ordering assumptions, N+1 queries, blocking work on the request path, unbounded caches, leaking listeners") is a dense checklist rather than explanation, and no basic concepts are re-taught, matching the every-token-earns-its-place anchor. | 5 / 5 |
Actionability | Guidance is concrete and quantitative throughout ("N≥20 runs", "0 failures in ≥1,000 calls", "3,000 realistic requests", "deployed p95 ≤ max(2× base p95, base p95 + 100 ms)", "flat over a 30-minute session", "k6"), but the measurement mechanics — e.g., the command or harness used to run the N trials or observe memory flatness — are not given, leaving minor gaps versus the copy-paste-ready anchor at 5. | 4 / 5 |
Workflow Clarity | The five-step procedure (measure → find cause → fix → prove → load-test constraint) has an explicit, quantitative validation stage in step 4 plus an Exit criteria checklist, so every checkpoint is present — exceeding the most-checkpoints-present anchor at 4 and matching the explicit-validation-with-checklist anchor at 5; the prove-it criteria inherently gate completion. | 5 / 5 |
Progressive Disclosure | This is a single-purpose skill under 50 lines with well-organized sections (Procedure, Exit criteria) and no need for external references; no bundle files ship with the skill, and the `qa-performance-resilience` mention is a counterpart-skill pointer rather than a dangling reference, so the simple-skill exception for a 5 applies. | 5 / 5 |
Total | 19 / 20 Passed |