Content
88%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 strong, highly actionable skill body: concrete commands, a full body template, explicit decision rules (draft when unverified, never open with failing checks), and a well-sequenced workflow with approval gates and recovery loops. Only minor room to trim asides and optionally split the GitLab template logic into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, project-specific, and assumes Claude's competence (no explanations of what a PR or Mermaid is), with every section carrying actionable rules. A few asides could be trimmed, e.g. "(Em-dashes read as machine-written and are a hard no)" and the parenthetical fallback notes in step 1, so it does not reach a 5. | 4 / 5 |
Actionability | Fully executable guidance throughout: concrete commands (`git log --oneline main..HEAD`, `git remote get-url origin`, `gh pr create --title ... --body-file ...`, `glab mr create --description ... --target-branch ...`), a complete GitHub body template, explicit provider-detection glob rules, and copy-paste-ready draft logic covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 0-9 are clearly sequenced with explicit validation checkpoints and feedback loops: self-review, running checks, "report them and ask the user whether to fix first or proceed" before proceeding, presenting the draft for approval, and the step-0 recovery loop ("If it folds edits back... If it reports an ambiguous case, resolve it by hand"). The destructive/batch cap does not apply since push/create actions are gated behind checks and explicit approval. | 5 / 5 |
Progressive Disclosure | Single-file skill (no references/, scripts/, or assets/ exist) with well-organized sections (Steps, Description rules, Provider assembly, Creating the PR/MR, Important) and only one-level references to repo files (CLAUDE.md, `lib/utils.sh`, `scripts/skills-guard.sh`), none nested. Minor gap: the detailed GitLab template-adaptation procedure could live in a separate reference file to slim the main body. | 4 / 5 |
Total | 18 / 20 Passed |