Content
82%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, action-oriented skill body built around executable bash workflows with a clear sequenced flow and a real validation checkpoint. The main improvements are trimming the bilingual redundancy and either bundling the referenced scripts or signaling their external location.
Suggestions
Remove or collapse the Japanese opener since it duplicates the frontmatter description and adds tokens without new information.
Bundle the referenced scripts (cursor-companion.sh, resolve-impl-backend.sh, model-routing.sh) under scripts/ or add a one-line pointer to where they live, so the inline references resolve.
Add an explicit validate→fix→retry loop in step 4 (e.g., 'if Cursor flags a regression, re-run the diff check after the host applies a fix') to push workflow_clarity toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, executable bash that assumes competence, but the Japanese opener ('Cursor Composer を read-only second opinion として使う…') restates the description bilingually and could be trimmed, so it sits at the efficient-but-not-fully-lean 4 rather than 5. | 4 / 5 |
Actionability | Four complete, copy-paste-ready bash blocks (root resolution, scope parsing, Cursor prompt, host review) cover the common cases with real commands and explicit argument handling, matching the fully-executable 5 anchor. | 5 / 5 |
Workflow Clarity | A clear four-step sequence with an explicit env-validation checkpoint (exit 2 on missing HARNESS_PLUGIN_ROOT); the operation is read-only so the destructive-cap does not apply, but there is no validate→fix→retry loop over Cursor's findings, leaving it just short of the 5 anchor. | 4 / 5 |
Progressive Disclosure | Sections are well-organized with no nested references and the body is self-contained, but it references scripts (cursor-companion.sh, resolve-impl-backend.sh, model-routing.sh) that are not present in any bundle directory, a minor navigation gap that holds it at 4 rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |