Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable single-file skill with strong workflow validation and clean sectioning, docked only for a duplicated description block and minor explanatory padding.
Suggestions
Replace the verbatim-repeated description in 'When to Use' with a one-line trigger summary to avoid token waste.
Trim the rebuild/HMR explanatory aside in branch mode to the essential 'no HMR — use --wait-for to gate the rebuild'.
Keep the rest as-is; the executable commands and validation checkpoints are already exemplary.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and signal-dense with executable commands, but the 'When to Use' section duplicates the frontmatter description verbatim and a few asides (e.g. the rebuild/HMR explanation) could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready bash for both stash and branch modes plus a concrete report-format template with explicit where/evidence/fix fields, matching the executable-code anchor. | 3 / 3 |
Workflow Clarity | Clear Audit → Report → Tear down sequence with explicit validation checkpoints for destructive ops (stash-failure 'warn and exit', git check-ref-format / rev-parse --verify, refusing option-like branch names) and a re-run-to-verify feedback loop. | 3 / 3 |
Progressive Disclosure | No bundle files exist (references/scripts/assets absent), so per the simple-skill note this single well-organized SKILL.md with clearly labeled sections (When to Use, Audit, Report, Tear down, Gotchas, Limitations) qualifies for 3. | 3 / 3 |
Total | 11 / 12 Passed |