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 content is a tight, command-driven workflow with a clear sequence and an early-exit checkpoint plus iterative user confirmation. It would benefit from a fully resolved apply example and an explicit post-apply verification, but is otherwise strong for a simple skill.
Suggestions
Add a complete `gh pr edit` example with concrete `--title`/`--body` values rather than ellipsis placeholders to close the actionability gap.
Add an explicit post-apply verification step (e.g. re-running `gh pr view --json title,body` to confirm the change landed) to strengthen the workflow checkpoint.
Clarify the iterative-suggest loop's stopping condition (e.g. 'until the user accepts or declines further changes') so the feedback loop is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — a numbered workflow with concrete `gh` commands and a short notes list — and assumes Claude's competence without explaining PR or git concepts, so every token earns its place. | 5 / 5 |
Actionability | Provides concrete, runnable commands (`gh pr view <pr> --json title,body`, `gh pr edit <pr> --title ... --body ...`) for the core cases, but the apply step uses placeholders rather than a fully resolved copy-paste example, leaving a minor gap. | 4 / 5 |
Workflow Clarity | Steps are clearly sequenced (resolve → gather → evaluate → report → suggest iteratively → apply) with an explicit stop checkpoint ('If not, stop here') and per-change user confirmation, but there is no explicit re-validation that the applied edit landed correctly, a minor checkpoint gap. | 4 / 5 |
Progressive Disclosure | For a simple, single-purpose skill under 50 lines with no external references needed, the content is well organized into a Workflow section and a Notes section, satisfying the simple-skill exception for a top score. | 5 / 5 |
Total | 18 / 20 Passed |