Content
75%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 dense, well-sequenced instruction skill that assumes competence and bakes in validation for a destructive batch operation. It is solid across all dimensions but leaves minor gaps: a few steps are high-level English rather than literal commands, and there is no explicit post-install verification.
Suggestions
Add an explicit post-install verification step (e.g., confirm the copied SKILL.md parses and .sn-version matches the upstream subtree SHA) before reporting success, since install overwrites existing skills.
Promote the high-level English steps to literal commands where feasible — e.g., give the sparse-checkout set command and the backup-retention prune command (ls/sort/tail | xargs rm) so they are copy-paste ready.
Tighten the partial-clone caveat (lines 64-69) to the essential warning that --filter=blob:none only stays small with --no-checkout plus sparse-checkout, trimming the explanatory aside.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and imperative with terse tables and bullets that assume git/YAML competence; the partial-clone blob:none caveat is a touch verbose but earns its place by preventing a real misunderstanding, so it sits just below the score-5 anchor. | 4 / 5 |
Actionability | Provides concrete commands (git log -1 --format=%H, git describe --tags --abbrev=0, --filter=blob:none --no-checkout) and exact paths/formats, but several steps (sparse-checkout re-apply, backup retention prune, move-into-bucket) are given as precise English rather than copy-paste commands. | 4 / 5 |
Workflow Clarity | Clear sequenced sections (scope → target → sync → compare → install → retention → report) with explicit validation (error-and-stop on missing upstream, backup-before-overwrite, retention pruning, separate error reporting); the gap is no explicit post-install integrity/load check, relevant for a destructive overwrite. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections separated by horizontal rules with easy navigation and no nested or buried references; at ~130 lines with no bundle files it has good structure but does not meet the score-5 anchor's one-level-deep reference split. | 4 / 5 |
Total | 16 / 20 Passed |