Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable bash commands and a well-sequenced workflow including validation checkpoints. The main weakness is minor verbosity from a duplicated notice block and placeholder template content.
Suggestions
De-duplicate the IMPORTANT notice block by defining it once and referencing it from the PR-body template to save tokens.
Move the per-repo upstream table or the PR body template into a reference file if the body grows, keeping the core workflow in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is instruction-focused and assumes competence, but the IMPORTANT notice block is duplicated (standalone and again inside the full template example), and the constraint list plus placeholder-heavy template add length that could be tightened. | 2 / 3 |
Actionability | Steps 1, 3, and 5 provide fully executable bash (gh auth status, gh pr list, gh repo fork, gh pr create) with real flags and clearly marked placeholders, making them copy-paste ready. | 3 / 3 |
Workflow Clarity | Six numbered steps are clearly sequenced with explicit validation checkpoints — prerequisite verification, an existing-PR duplicate check, and skip-and-log error handling for an outward-facing operation. | 3 / 3 |
Progressive Disclosure | No bundle files are present; the skill is a single self-contained SKILL.md with well-organized sections (When to invoke, Steps, Per-repo table, Constraints) and one-level navigation, which suits a single-purpose skill. | 3 / 3 |
Total | 11 / 12 Passed |