Content
81%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.
An exemplary operational skill body: a fully sequenced workflow with genuine validation checkpoints (submodule guard, ignore-status verification, baseline tests) and error-recovery paths, written in tight, command-first Chinese prose with two useful summary tables. The only deductions are minor: placeholder variables in the worktree-creation snippet and some redundancy between the quick-reference and rationalization tables.
Suggestions
In the worktree-creation block, replace the implied $LOCATION/$BRANCH_NAME placeholders with concrete example values or an inline one-line derivation (e.g. path=".worktrees/$BRANCH_NAME") so the command is copy-paste ready.
Consider folding the '快速参考' and '常见的合理化借口' tables into one table (situation → action → excuse it defeats) to cut the duplication and tighten token use.
If the skill grows, move the per-ecosystem setup/test matrix (步骤 2/3) into a references/ file so SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: commands come with one-line comments, justifications are single sentences ("**为什么关键:** 防止 worktree 内容被意外提交到仓库"), and it never explains concepts Claude already knows. It stops short of anchor 5 only because the '常见的合理化借口' table and the '快速参考' table restate rules already spelled out in the steps — one of the two could be trimmed. Comfortably above anchor 3's 'some unnecessary explanation'. | 4 / 5 |
Actionability | Nearly everything is copy-paste-ready bash: the GIT_DIR/GIT_COMMON detection, the submodule guard, `git check-ignore -q`, the per-ecosystem setup and test commands. The gap that keeps it from anchor 5 is the creation block `path="$LOCATION/$BRANCH_NAME"` / `git worktree add "$path" -b "$BRANCH_NAME"`, which uses placeholder variables whose values are only implied by the prose priority list rather than given concretely. | 4 / 5 |
Workflow Clarity | Steps 0-3 are explicitly sequenced (detect existing isolation → create via native tool or git fallback → project setup → baseline validation), with real validation checkpoints: the submodule guard, the mandatory `git check-ignore` verification before creation, baseline tests before any work, and recovery paths (sandbox fallback to work in place, ask-the-user on test failure). The quick-reference table doubles as a checklist — a clear match for anchor 5's 'explicit validation steps, feedback loops, checklists'. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the body references no external paths, so there are no broken or buried references; sections are clearly headed and easy to navigate. It scores 4 rather than 5 because at ~165 lines, some content (the per-language setup/test matrix and the two summary tables) could plausibly live in a reference file — the 'no external references needed' exemption is scoped to skills under 50 lines. Still well above anchor 3, which requires inline content that clearly belongs elsewhere or buried references. | 4 / 5 |
Total | 17 / 20 Passed |