Content
93%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 tight, fully actionable setup guide: concrete paths, ready-to-paste settings JSON for both scopes, and an end-to-end verification step with expected behavior. The only gap is the absence of troubleshooting/error-recovery guidance if the step-5 verification fails, which keeps workflow clarity at 4 rather than 5.
Suggestions
Add a short fallback to step 5 for the failure case, e.g., '若未阻止:检查 script 是否可执行、settings JSON 中 command 路径是否正确,修正后重新测试', to close the feedback-loop gap.
Note that jq is required by the bundled script so users on minimal environments can install it before verification fails mysteriously.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout ("用 chmod +x 让它可执行", "添加到对应 settings file") with no explanation of concepts Claude already knows. The single behavioral note ("被阻止时,Claude 会看到一条 message...") conveys functional information, so it does not fit the 'some unnecessary explanation' anchor 3. | 5 / 5 |
Actionability | Fully executable guidance: exact copy destinations per scope, chmod command, copy-paste-ready JSON hook configs for both project and global settings, a merge instruction, and a concrete verification command with the expected exit code ("应以 code 2 退出,并向 stderr 打印 BLOCKED message"). This matches the copy-paste-ready anchor 5 and exceeds anchor 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | A clear five-step sequence with an explicit verification checkpoint (step 5: pipe a test command into the script and check for exit code 2 plus a stderr BLOCKED message). It is not 5 because there is no error-recovery guidance if verification fails (no fix-and-retry loop); it is above anchor 3 because validation is present and explicit, and the destructive-operation cap does not apply since this workflow installs (not performs) destructive operations. | 4 / 5 |
Progressive Disclosure | The body is a well-sectioned overview that keeps the blocking logic in the bundled script, referenced by a clear one-level-deep relative link ([scripts/block-dangerous-git.sh](scripts/block-dangerous-git.sh)) that resolves to a real file. Nothing that belongs in a separate file is inlined, fitting the simple-skill exception for a well-organized single-purpose skill. | 5 / 5 |
Total | 19 / 20 Passed |