Content
65%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 a crisp, command-driven runbook with excellent token efficiency and copy-paste git commands, but it has two structural weaknesses: destructive batch operations (branch deletion, worktree cleanup) proceed without any post-merge validation, and its only external dependency (scripts/session_manager.py) is missing from the bundle entirely. Fixing the missing script and adding merge-success verification would lift the two weakest dimensions.
Suggestions
Add a post-merge validation checkpoint: check the `git merge --no-ff` exit status (and a conflict-recovery path such as `git merge --abort`) before proceeding to archive losers and clean worktrees.
Before `git branch -D`, verify each archive tag was created successfully (e.g., `git tag -l hub/archive/{session-id}/*`) so losing commits are confirmed preserved before deletion.
Ship `scripts/session_manager.py` in the bundle (the scripts/ directory is absent) or inline the equivalent cleanup/state commands, and specify where the /hub:eval winner ranking and the session's base branch are read.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (e.g., bare `git tag`/`git branch -D` commands with one-line comments, no git-concept explanations), but there is minor trimmable redundancy: the fact that losing commits are "preserved via tags" is stated three times (two code comments plus the Safety bullet "Archive, don't delete — losing agents' commits are preserved via tags"), and the opening sentence repeats the frontmatter description. This fits 'efficient with minor instances that could be trimmed' rather than 'every token earns its place'. | 4 / 5 |
Actionability | Commands are concrete and executable (`git checkout {base_branch}`, `git merge --no-ff hub/{session-id}/{winner}/attempt-1 -m "..."`, `git tag hub/archive/{session-id}/{agent-id} ...`, `python {skill_path}/scripts/session_manager.py --cleanup {session-id}`), matching 'mostly executable with minor gaps'. It is not a 5 because key details are missing: nothing shows how to determine `{base_branch}` or where the #1 ranking from the most recent `/hub:eval` is read, and the session_manager.py CLI is invoked without documenting its flags. It is not a 3 because the code is real and executable, not pseudocode. | 4 / 5 |
Workflow Clarity | The six steps are clearly numbered and there is one explicit checkpoint ("Confirm with user before merging — show the diff summary first"), but the workflow then performs batch destructive operations — `git branch -D` on every losing agent and worktree cleanup — with no verification that the merge succeeded (no exit-status check, conflict handling, or `git merge --abort` path) and no confirmation that archive tags were created before branches are deleted. Per the judging guidelines, destructive/batch workflows missing validation are capped at 3; it is not a 4 because these validation gaps are significant, not minor. | 3 / 5 |
Progressive Disclosure | Sections are well organized (Usage, What It Does with six numbered subsections, Safety, After Merge) and the inline content is appropriately sized, but scoring against the actual bundle structure reveals a significant gap: the bundle contains no files at all — no references/, scripts/, or assets/ — yet steps 4 and 6 load-bearingly invoke `{skill_path}/scripts/session_manager.py`, which does not exist. A missing script that two of six steps depend on is more than a minor organization gap, placing this at 3 rather than 4; it is above 2 because the body itself is well structured with no buried or nested references. | 3 / 5 |
Total | 14 / 20 Passed |