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 a tight, well-structured git/PR workflow with executable commands and a useful pre-flight checkpoint. Its main gap is the absence of validation/feedback steps after pushing and creating the PR, and a lack of a fully worked concrete example.
Suggestions
Add a verification step after pushing and after `gh pr create` (e.g. check the PR URL output or run `gh pr view`) to close the workflow with a feedback loop.
Include one fully worked concrete example (real username, branch, type, title) so the template is copy-paste ready without substitution.
Clarify what to do if the pre-flight `git remote -v` shows a wrong origin — currently it only comments the fix command without a re-check instruction.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: a short pre-flight check, a compact command block, and terse notes, with no explanation of concepts Claude already knows. Every line (remote check, branch-from-main reminder, type enum) earns its place, matching 'lean and efficient; assumes Claude's competence'. | 5 / 5 |
Actionability | It provides concrete, executable bash commands with a real example URL and concrete type values, but relies on placeholders (<github-username>, <files>, <body>) with no fully worked concrete example. This fits 'mostly executable guidance; concrete commands with minor gaps'; a 5 would require a worked example covering common cases. | 4 / 5 |
Workflow Clarity | The sequence is clear (pre-flight check, then checkout/pull/branch/add/commit/push/pr-create) and the pre-flight remote check is an explicit checkpoint. It is not a 5 because there are no feedback loops (e.g. verify push succeeded, confirm PR opened) and not a 3 because a checkpoint is present and steps are well defined; the destructive-cap does not apply since no force/delete/batch operation is involved. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with three well-organized sections (飞行前检查, 命令, 注意事项) and no need for external bundle files, so per the simple-skills note it scores 5. The single pointer to .github/PULL_REQUEST_TEMPLATE.md is an appropriate one-level repo reference. | 5 / 5 |
Total | 18 / 20 Passed |