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.
A tight, well-structured body that only teaches what Claude could not infer — plan location, status conventions, git identity rules, and reporting protocol. The only soft spots are a placeholder-laden command and one vague workflow step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every line carries project-specific facts Claude would not already know (the auto-synced plan path, the `[ ]`/`[~]`/`[x]` status conventions, the @mention reporting requirement). No padding or explanations of known concepts — matches the top anchor. | 5 / 5 |
Actionability | Concrete, runnable commands are given (`cat ~/shared/projects/{project-id}/plan.md`, both `git config` lines), but the placeholders `{project-id}` and `<your-worker-name>` require substitution and "Execute the task following normal task execution flow" is vague direction rather than instruction. Solidly above the midpoint but not fully copy-paste ready — 4, not 3 (real executable commands dominate) and not 5 (one vague step remains). | 4 / 5 |
Workflow Clarity | The Workflow section gives a clear three-step sequence (mark started → execute → report) and the Gotchas section surfaces critical checkpoints (read plan directly, set git author before commits, @mention to advance). It is 4 rather than 5 because no explicit verification of any step is described, and 4 rather than 3 since the operations are non-destructive so the validation cap does not apply and most checkpoints are present. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, has no bundle files, and needs no external references; the four sections (Gotchas, Project Context, Workflow, Git Config) are well organized and easy to navigate. Per the rubric's simple-skill guideline this earns a 5. | 5 / 5 |
Total | 18 / 20 Passed |