Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tight, actionable 5-step workflow with executable commands and a sensible preview-before-clone validation step. Its main gaps are a duplicated opening line and a missing error-recovery branch for the destructive discard step.
Suggestions
Drop the opening line that repeats the frontmatter description; the steps are self-explanatory and the duplicate costs tokens.
Add an explicit recovery branch after step 3, e.g. "If the first/last messages do not match, re-check the session ID from history before proceeding — do not run the clone."
Tighten the step 2 sub-bullets by keeping only the version-sort note and folding the plugin/symlink rationale into a single concise line.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and command-driven, but the opening line duplicates the frontmatter description and a few explanatory sub-bullets (e.g. version-sort rationale) pad beyond what Claude could infer, keeping it just short of the every-token-earns-its-place anchor. | 2 / 3 |
Actionability | Steps 1, 2, and 5 give fully executable bash/CLI commands, and the <script-path>, <session-id>, <project-path> placeholders are concrete values resolved earlier in the workflow, so the guidance is copy-paste ready rather than pseudocode. | 3 / 3 |
Workflow Clarity | The 5-step sequence is clear and step 3 is an explicit preview/verification checkpoint, but because the operation discards earlier context (destructive) there is no stated error-recovery feedback loop (what to do if the preview does not match), which the 3-anchor expects. | 2 / 3 |
Progressive Disclosure | The skill is under 50 lines, needs no external references, and is well-organized as numbered steps with sub-bullets, satisfying the simple-skill allowance for a top progressive-disclosure score. | 3 / 3 |
Total | 10 / 12 Passed |