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 SKILL.md body: lean, fully executable, and organized around four sequenced workflows with explicit verification and feedback loops. Detail is appropriately pushed to two well-signaled, one-level-deep reference files that exist in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with executable commands, tables, and short policy bullets; every explanatory sentence carries repo-specific facts Claude cannot know (ruleset enforcement, required check names, approval dismissal, bot push behavior). There is no padding and no explanation of general git/GitHub concepts — e.g. the "--force-with-lease" note exists only to justify a destructive-operation rule — so anchor 5's "every token earns its place" fits better than anchor 4's "minor instances of over-explanation". | 5 / 5 |
Actionability | Copy-paste-ready bash blocks throughout: "git commit -s -S -m \"Fix short description (#ISSUE)\"", "gh pr merge <PR> --squash --delete-branch", "gh run view <RUN_ID> --log-failed", plus concrete real check names ("Super-linter", "libFuzzer (ASan + UBSan)") and a failing-check→fix table. Fully executable guidance covering the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Four workflows are clearly sequenced with explicit validation checkpoints ("Verify before moving on: 1. git log --show-signature -1 ... 2. gh pr checks <PR>") and explicit feedback loops ("repeat from step 1 until no unresolved threads remain and `gh pr checks <PR>` is green"; "push and re-run gh pr checks until every required check is green"). The destructive force-push path uses --force-with-lease with warnings, and merge has an ordered check-then-act list — anchor 5's validation, recovery loops, and checklists are all present. | 5 / 5 |
Progressive Disclosure | The core workflows stay inline while detail is split one level deep into two real, verified bundle files, each with an explicit read-when signal: "commands.md: read when you need a gh command not shown above" and "troubleshooting.md: read when a merge is blocked, threads will not resolve, a bot pushed unsigned commits, or a push is rejected". Point-of-need pointers in the body ("see references/troubleshooting.md", "references/commands.md#fork-workflow") make navigation easy — anchor 5. | 5 / 5 |
Total | 20 / 20 Passed |