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.
The body is an exemplary router-style skill: lean gotchas encoding hard-won operational constraints, a clean situation→reference dispatch table, and all referenced bundle files present and one level deep. The only room for improvement is that some inline operations (e.g., MinIO sync) are named without any inline command, relying fully on the references for executable detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is dense with non-obvious operational knowledge only ("Check YOLO mode BEFORE drafting the plan", "Do NOT proceed to next phase while REVISION_NEEDED is pending", the exact shell test `[ "${AGENTTEAMS_YOLO:-}" = "1" ] || [ -f ~/yolo-mode ]`) with zero padding and no explanation of concepts Claude already knows. Every token earns its place, matching anchor 5; anchor 4 requires over-explanation worth trimming, which is absent. | 5 / 5 |
Actionability | The body gives a copy-paste-ready shell check for YOLO mode, a situation→document routing table, and concrete imperatives ("always invite admin", "Always sync to MinIO after changes", "use references/plan-format.md as the canonical format"). It is mostly executable guidance with minor gaps — operations like MinIO sync and task assignment are named but their commands live in the reference files, so it sits at anchor 4 rather than anchor 5's fully copy-paste-ready coverage, and well above anchor 3's pseudocode-level guidance. | 4 / 5 |
Workflow Clarity | The body is a router with explicit ordering guards ("Check YOLO mode BEFORE drafting the plan", "Do NOT proceed to next phase while REVISION_NEEDED is pending", "'All tasks complete' step is mandatory") plus a situation→doc table that sends each operation to a step-by-step reference, all of which exist. This is clear sequencing with most checkpoints present, but the actual validation/feedback loops for the batch task lifecycle are delegated to the references rather than visible here, holding it at anchor 4 instead of anchor 5's explicit inline validate→fix→retry steps. | 4 / 5 |
Progressive Disclosure | The body is a concise overview with a clear Situation→Read table pointing to four one-level-deep reference files (create-project.md, task-lifecycle.md, plan-format.md, plan-changes.md), all of which exist in the bundle, along with an explicit instruction to load only the relevant one ("Do not load all of them"). This matches anchor 5 exactly — well-signaled, appropriately split, easy navigation; anchor 4 would require organization gaps that are not present. | 5 / 5 |
Total | 18 / 20 Passed |