Content
100%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, fully actionable commands, a clearly sequenced workflow with guards and validation checkpoints, and clean single-page organization with no unnecessary references. Nothing meaningful is missing or padded.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout — no git/GitHub concept explanations, no padding. Lines like "Stage the intended files explicitly (`git add <paths>`) — don't blindly `git add -A`" and "use `--force-with-lease`, never `--force`" add only non-obvious repo-specific policy. Every token earns its place, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | Guidance is fully executable: concrete commands for every step (`git branch --show-current`, `npx prettier --write <changed files>`, `git push -u origin <branch>`, and a copy-paste-ready `gh pr create` heredoc example), plus specific file paths for the PR template and scope map. Edge cases (nothing to commit, PR already exists, deps not installed) are handled explicitly. | 5 / 5 |
Workflow Clarity | A clearly numbered five-step sequence with explicit checkpoints: a base-branch guard that stops before committing, skip conditions when there is nothing to commit, a prettier check before committing, honest test-plan checkbox handling, and a confirmation checkpoint before the outward-facing `gh pr create`. Error recovery is present (surface the existing PR URL instead of erroring), satisfying the validation-and-feedback-loop anchor. | 5 / 5 |
Progressive Disclosure | The skill is a single-page, well-sectioned workflow (numbered steps plus a Notes section) with no bundle files and no content that needs offloading — the referenced files (.github/PULL_REQUEST_TEMPLATE.md, pr-scope-map.json) are user-repo inputs, not nested skill references. Per the rubric's simple-skill guideline, well-organized sections alone merit the top score here. | 5 / 5 |
Total | 20 / 20 Passed |