Content
96%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.
An exceptionally well-built operational skill: exact commands, safety gates, and validation checkpoints for destructive git operations with zero padding. The sole structural weakness is the PR-attachment section, which references an out-of-bundle document and sits outside the skill's core scope.
Suggestions
Move the PR Body Evidence Attachments section into a separate reference file in a references/ bundle directory (or drop it if the referenced docs/reference/github-attachment-upload.md is repo-specific), keeping SKILL.md focused on commit, rebase, history, and status modes.
If the attachment guidance stays inline, link it as a proper relative bundle path (e.g. references/github-attachment-upload.md) so the referenced file ships with the skill and the reference is verifiable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout — no concept explanations of git basics, every section carries operational weight (mode gate, safety checks, command selection rules), and the ground-truth command block is presented without narration. Matches 'every token earns its place', not the 'minor instances of over-explanation' anchor below. | 5 / 5 |
Actionability | Fully executable guidance: copy-paste-ready commands with exact flags ("GIT_SEQUENCE_EDITOR=: git rebase -i --autosquash <base>", "--force-with-lease", "git log -S", "git blame -L start,end -- file") covering the common commit, rebase, and history cases. This is the top anchor, a step above 'concrete commands with minor gaps'. | 5 / 5 |
Workflow Clarity | Clear mode classification, a pre-write safety checklist, per-commit verification ("verify git diff --staged --stat" before, "git log -1 --oneline" after), post-rebase smoke checks, and explicit recovery paths (rebase --abort, reflog). Destructive operations have feedback loops, so the destructive-cap is not triggered and the full validation anchor fits. | 5 / 5 |
Progressive Disclosure | Well-organized single-file structure with clear section navigation, but the "PR Body Evidence Attachments" section references "docs/reference/github-attachment-upload.md" — a repo-relative path outside the skill bundle that cannot be verified as a real skill reference — and is tangential to the skill's stated git scope. Fits 'good structure with minor organization gaps' rather than the clean one-level-deep reference structure of the top anchor. | 4 / 5 |
Total | 19 / 20 Passed |