Content
56%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 content is actionable and reasonably well-sequenced with a validation checkpoint, but it is token-heavy due to redundant example volume and duplicated anti-pattern lists, and it does not leverage progressive disclosure to offload the bulky examples.
Suggestions
Reduce the five full PR-description examples to two or three representative ones and move the rest into a references file.
Remove the duplicated 'What to Avoid' / 'Anti-Patterns to Avoid' lists — keep a single canonical list.
Add an explicit error-recovery step for 'gh pr create' failures (e.g., auth issues, base branch mismatches) to complete the workflow's feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose: five full worked example PR descriptions (~30 lines each) are excessive, and the 'What to Avoid' / 'Anti-Patterns to Avoid' lists are duplicated in both the Generate and Notes sections. | 2 / 5 |
Actionability | Provides concrete, mostly executable commands (git branch/log/diff, 'gh pr create --title ... --body-file ...') and a clear write-to-temp-file step, with only minor gaps such as the templated title and narrative write-tool instruction. | 4 / 5 |
Workflow Clarity | A clear six-step sequence with a validation checkpoint in step 1 ('If on main/master or no commits ahead, inform the user'), but lacks an error-recovery feedback loop for the gh pr create step. | 4 / 5 |
Progressive Disclosure | Sections are well organized, but the skill is a 350-line monolith with no bundle files; the five long examples and reference-style guidance are inlined rather than split into a separate references file. | 3 / 5 |
Total | 13 / 20 Passed |