Content
78%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 concise, well-organized instructional skill with clear write-operation checkpoints. Its main weakness is progressive disclosure: the body repeatedly points to reference/workflows.md for templates and process details, but that file is absent from the bundle.
Suggestions
Create the referenced reference/workflows.md (or references/workflows.md) with the PR/Issue templates and tool-selection details the body promises, so the navigation target actually exists.
Inline a minimal concrete example or two (e.g. a skeleton PR title/body template, or the specific GitHub MCP tool names for 查重 and 创建 PR) to raise actionability without waiting on the external file.
Make the merge-prep validation steps explicit as a checklist (review 状态 ✓ / check runs ✓ / 冲突风险 ✓ / 用户授权 ✓) to push workflow_clarity from mostly-checkpointed to fully checkpointed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-sectioned (适用场景、不适用场景、快速指导、高信号规则、关键陷阱) with no padding or explanation of concepts Claude already knows; every token earns its place. | 5 / 5 |
Actionability | Concrete guidance is present (先读后写 checklist, 查重/看 diff/展示拟提交内容 rules, merge-prep checklist), but it defers concrete templates and tool choices to reference/workflows.md rather than giving copy-paste-ready specifics; minor gaps. | 4 / 5 |
Workflow Clarity | The 先读后写 sequence provides clear ordered checkpoints with validation before destructive write ops and a merge-prep checklist, matching the clear-sequence-with-most-checkpoints anchor; a few checkpoints are implicit rather than explicit. | 4 / 5 |
Progressive Disclosure | Structure is good and references are one level deep, but the referenced file reference/workflows.md does not exist in the bundle (references/, scripts/, assets/ are empty), so the navigation points to a missing target — content that should be separate is deferred to a non-existent file. | 3 / 5 |
Total | 16 / 20 Passed |