Content
100%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 instruction-only skill body: fully executable git commands, a clearly sequenced workflow with explicit validation and conflict-recovery paths, and lean well-organized sections with no bundled files needed. Nothing material is missing or padded.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout — every section is either a guardrail, a concrete command, or a validation check, with zero explanation of git concepts Claude already knows (e.g., "Check for uncommitted changes: git status --porcelain"). Not a 4 because there is no padding or over-explanation anywhere to trim. | 5 / 5 |
Actionability | Every step is an executable, copy-paste-ready command with explicit placeholders (e.g., "git -C <main-worktree-path> merge <topic-branch>", "git -C <main-worktree-path> merge-base --is-ancestor <topic-branch> HEAD"), and conflict resolution covers the common case including the abort path. Not a 4 because no key execution detail is missing. | 5 / 5 |
Workflow Clarity | The workflow is clearly sequenced (commit uncommitted changes → merge → resolve conflicts → validate) with an explicit Validation section containing two verification commands, and conflict handling includes error-recovery feedback (resolve-and-stage, ask user, or "merge --abort"). The destructive-operation validation cap does not apply because validation steps are present. Not a 4 because checkpoints are explicit rather than implicit, covering both a clean worktree and full-merge verification. | 5 / 5 |
Progressive Disclosure | The skill is a short, single-purpose procedure with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references; it is organized into well-signaled sections (Guidelines, Workflow, Validation) that keep everything one level deep. Per the rubric's simple-skill guidance, this warrants a 5. Not a 4 because there is no content that should have been split out into separate files. | 5 / 5 |
Total | 20 / 20 Passed |