Content
85%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 well-structured, lean, actionable instruction-only skill with a clear sequenced workflow, explicit validation before publishing, and thoughtful failure handling (duplicate PRs, auth errors, unresolvable links). Remaining gains are small: tighten the duplicated template-freshness bullets and add the exact gh commands.
Suggestions
Merge the two overlapping bullets about preferring the live template over remembered/stale copies into a single rule to remove redundancy in the 'Read the current template' section.
Include the concrete commands for the creation safeguards, e.g. `gh pr list --head <branch>` for the existing-PR check and a full `gh pr create --title-file/--body-file` example, to close the last actionability gap.
The bug-fix bullet enumerates setup, repro, expected, and observed behavior — consider compacting it into a short labeled list format so it reads as a fill-in pattern rather than a long sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative guidance with no padding about concepts Claude already knows — every bullet instructs. Two bullets redundantly state the same template-freshness rule ('Do not copy its structure into this skill or reuse a remembered version' vs. 'Prefer the actual current PR template over stale copies of its structure in other guidance'), which is a minor trim, matching anchor 4 rather than the fully lean 5. | 4 / 5 |
Actionability | Concrete, specific guidance throughout: template search paths ('repository root, .github/, and docs/'), a required field list for bug fixes (setup, repro steps, expected vs. observed), and exact mechanics ('write the exact Markdown to a temporary file and use --body-file'). It stops short of showing the actual `gh pr create` invocation and duplicate-check command, so it is 'mostly executable with minor gaps' rather than fully copy-paste ready. | 4 / 5 |
Workflow Clarity | A clear four-phase sequence (read template → write description → link related work → create PR) with an explicit pre-publish checkpoint ('compare the finished description with every template section... Confirm that claims match the diff, links are accurate, and no placeholders remain') and error-recovery feedback loops ('If creation has an ambiguous result, check whether it succeeded before retrying to avoid duplicates. Report unresolved authentication or permission failures instead of repeatedly retrying'). This is not a destructive/batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with no external references needed and no references/scripts/assets bundle present; per the rubric's simple-skill guidance, well-organized sections (Read the current template, Write the description, Link related work, Create the PR) suffice for a 5. | 5 / 5 |
Total | 18 / 20 Passed |