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 well-engineered operational skill: lean, tightly written, with a fully sequenced workflow and genuine safety validation around checkout, instance reuse, and cleanup. The main weaknesses are partial dependence on an external cross-skill reference (not bundled here) for the Electron/CDP mechanics and an inline report template that could live in a reference file.
Suggestions
Bundle the Electron instance procedure (or a local copy/pointer card) under references/ so the skill is self-contained; as written, step 2 and 3 cannot be executed if ../cherry-electron-dev/references/electron-instance.md is absent.
Move the ~35-line report template to references/report-template.md and keep a one-line pointer plus required fields in SKILL.md to reduce inline bulk.
Add one concrete example of the static-analysis checks (e.g., the grep or file-listing command used to find blocked v1/v2-refactor files) so the 'Also check' list is executable rather than advisory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — 'Require authenticated gh, pnpm', 'Do not use broad process or port cleanup', 'Record the exact checked-out HEAD' — with zero explanation of concepts Claude already knows (no Electron/CDP/git tutorials). The inline report template is task content, not padding; every section instructs rather than describes. | 5 / 5 |
Actionability | Concrete, executable commands appear at each step — 'gh pr list --repo CherryHQ/cherry-studio --state open --limit 10 --json ...', 'gh pr checkout <NUMBER>', 'pnpm typecheck', 'mkdir -p /tmp/pr-<NUMBER>' — plus a complete copy-paste report template. Minor gaps: Electron launch and the CDP controller are delegated to the shared reference with no local command or fallback if that reference is unavailable, leaving step 2/3 partially non-executable from this file alone. | 4 / 5 |
Workflow Clarity | A clearly sequenced 5-step workflow (resolve/inspect → analyze/start → test → clean up/restore → report) with explicit validation checkpoints for the risky operations: 'Record the current branch for restoration', 'Never discard local changes. Stop and ask if checkout would overwrite them', 'Reuse only an instance ... whose recorded launch HEAD equals the checked-out PR HEAD', and a branch-restore fallback ('If it no longer exists, resolve the repository default branch and report the fallback before switching'). This matches the top anchor: clear sequence, explicit validation, error-recovery paths. | 5 / 5 |
Progressive Disclosure | Good single-file structure with clear sections and a well-signaled, one-level-deep delegation to '../cherry-electron-dev/references/electron-instance.md' ('read ... and select its ephemeral policy'). Two organization gaps keep it below 5: the ~35-line report template is inlined in SKILL.md where a reference file would fit, and the skill's single critical dependency lives outside its own bundle — no references/, scripts/, or assets/ exist here, so the Electron instance procedure is not locally discoverable. | 4 / 5 |
Total | 18 / 20 Passed |