Content
86%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.
The body is an exemplary instruction-only skill: concrete commands with exact flags, explicit escalation and failure-handling feedback loops for destructive operations, and clean section organization. The only minor weaknesses are slightly abstract Inputs/Outputs sections and an implied rather than explicit step ordering.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean rule set with zero re-explanation of git concepts Claude already knows, and every rule carries concrete flags. The 'Inputs' and 'Outputs' sections are somewhat abstract and could be trimmed, which keeps it below the 'every token earns its place' anchor of 5. | 4 / 5 |
Actionability | The guidance is copy-paste-ready throughout: 'git push --force', '--force-with-lease', 'git diff main', 'git diff --staged', 'git clean -fdx', 'git reset --hard', 'git tag -a vX.Y.Z', and 'git log --oneline origin/branch..HEAD' cover the common cases with exact commands and flags. | 5 / 5 |
Workflow Clarity | Validation is present and explicit for destructive operations: an escalation checklist ('Stop and confirm with the user if...'), review gates ('git diff main', 'git diff --staged'), and a Failure Modes section with feedback loops (surface hook output, never auto-resolve conflicts, present diverged history). It falls short of 5 only because the operating sequence is implied by rule ordering rather than presented as an explicit ordered workflow. | 4 / 5 |
Progressive Disclosure | A compact (~63-line) self-contained skill with well-organized sections, no monolithic content that belongs in separate files, and clearly signaled one-level-deep references (external URLs in a References section). Per the simple-skill guidance, well-organized sections suffice here. | 5 / 5 |
Total | 18 / 20 Passed |