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 exemplary instruction-only skill body: lean, safety-first, and packed with exact commands and validation checkpoints for destructive git operations. The only structural weakness is progressive disclosure — one dangling reference to a non-bundled docs path and a tangential PR-attachment section that slightly dilutes the mode-focused organization.
Suggestions
Verify docs/reference/github-attachment-upload.md actually exists at that path (it is not part of the skill bundle) and consider making it a bundled references/ file so the reference resolves reliably.
Move the PR Body Evidence Attachments section into a separate reference file, keeping SKILL.md focused on the four core modes (COMMIT, REBASE, HISTORY, STATUS).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout with zero concept padding — no explanation of what git or rebase is, just rules like 'Never rebase or rewrite main, master, dev... unless the user explicitly named that exact operation'. Every token earns its place and assumes Claude's competence. | 5 / 5 |
Actionability | Fully executable guidance: a copy-paste bash block of ground-truth commands, exact tool selection per question type (git log -S, git blame -L start,end -- file, git log --follow), and precise recipes like 'git commit --fixup=<hash> followed by GIT_SEQUENCE_EDITOR=: git rebase -i --autosquash <base>'. As an instruction-only skill, its guidance is concrete and specific throughout. | 5 / 5 |
Workflow Clarity | Commit Mode is a numbered 7-step sequence with per-commit validation checkpoints ('Before each commit, verify git diff --staged --stat'), plus a Safety Checks checklist before any write, an explicit recovery path ('use git rebase --abort first. Use reflog only after explaining the recovery path'), and post-rewrite smoke verification — clear sequencing with explicit validation and feedback loops for destructive operations. | 5 / 5 |
Progressive Disclosure | Sections are well-organized by mode with all inline content appropriately placed for a ~100-line skill, and the single external reference ('docs/reference/github-attachment-upload.md') is clearly signaled and one level deep. However, that path does not exist in the skill bundle (no references/ directory), and the PR Body Evidence Attachments section is tangential to the four core modes, leaving minor organization gaps. | 4 / 5 |
Total | 19 / 20 Passed |