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 tight, well-structured operational runbook: an unambiguous reset procedure with explicit verification and a symptom-cause-fix table, plus a valuable Do-not section guarding against dangerous generic actions. The only weakness is placeholder indirection (`<reset-script>`, `<app-cli>`, vague thread-list command) that forces the reader to resolve concrete commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries app-specific knowledge Claude cannot infer — the per-thread subprocess model, "There is no global Cursor ACP server", the "Failed to initialize session services" login symptom, the session/load failure mode — with no padding or generic explanation. This matches anchor 5 (lean and efficient; every token earns its place), not anchor 4, because there is no over-explanation to trim. | 5 / 5 |
Actionability | The reset section gives a concrete, flag-documented command block (`<reset-script> <thread-id>`, `--self`, `--dry-run`, `--kill-all`) that maps to the real scripts/reset-cursor-acp.sh, and known causes pair symptoms with fixes. It stops short of anchor 5 because the placeholders `<reset-script>` and `<app-cli>` must be resolved by the reader and thread-ID discovery is only "the app's status or thread-list command" rather than a concrete command. | 4 / 5 |
Workflow Clarity | The sequence is explicit — run the script, then a dedicated Verify section ("Send one short message to verify a fresh agent responds"), then diagnose via Known causes before another reset — with feedback loops (symptom → fix → "then reset") and a `--dry-run` guard for the destructive kill. This matches anchor 5 (explicit validation steps and error-recovery loops), and the destructive-operation cap of 3 does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | The ~49-line body is cleanly sectioned (How resets work, Quick reset, Verify, Known causes, Do not) with a single real bundle file (scripts/reset-cursor-acp.sh), and details like CLI internals correctly live in the script rather than the body. It falls short of anchor 5 because the script is referenced through the `<reset-script>` placeholder with "Resolve <reset-script> relative to this SKILL.md" instead of a clear, well-signaled path such as scripts/reset-cursor-acp.sh. | 4 / 5 |
Total | 18 / 20 Passed |