Content
38%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 has a promising timed structure (30 seconds / 5 minutes / 10+ minutes) and some genuinely concrete command content, but it is undermined by heavy redundancy, a contradictory account of how worktrees are created, a narrative rather than executable example workflow, and references to five module files that are missing from the bundle.
Suggestions
Ship the five modules/ files referenced throughout the body, or consolidate their content and remove the broken 'Refer to X Module at modules/...' pointers — currently every deep-dive link is dead.
Resolve the creation contradiction: section 1 claims `moai worktree new <name>` creates trees while section 2 says `moai worktree` has no creation verb; state the single authoritative creation path.
Merge the duplicated phase descriptions (sections 3 and 4) and the Use Cases / Quick Decision Guide overlap, and rewrite the example workflow as actual commands instead of narrative prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose and redundant: the intro sentence restates the description almost verbatim, sections 3 and 4 describe the same Plan/Dev/Sync/Cleanup phases twice, the 'Quick Decision Guide' restates the 'Use Cases' list, and 'Detailed Reference: Refer to X Module' is repeated about a dozen times. 'Core Philosophy' and phrases like 'true parallel development' and 'seamless integration' add padding, and it explains git worktree concepts Claude already knows. Not 1 because concrete command tables and code examples are present. | 2 / 5 |
Actionability | There is genuine executable content — the management command table, the `moai cc -w <name> --spawn` bash examples, and sync strategy flags — but the primary workflow has key gaps and an internal contradiction: section 1 says trees are 'created by `moai worktree new <name>`' while section 2 states '`moai worktree` has no creation verb', and the example workflow in section 3 is narrative prose ('create a worktree for SPEC-001 with a description like...') with no commands. Not 4 because the creation step, the core action of the skill, is ambiguous. | 3 / 5 |
Workflow Clarity | The phases are listed (Plan/Dev/Sync/Cleanup) and a Verification checklist exists at the end, but the sequence is duplicated across two overlapping sections, the example workflow lacks executable steps, and the destructive commands (remove, clean) have no pre-flight validation or checkpoints. Not 4 because validation is implicit and the step sequence is not consolidated. | 3 / 5 |
Progressive Disclosure | The body is structured as an overview pointing to five deep-dive module files ('modules/worktree-commands.md', 'modules/worktree-management.md', 'modules/parallel-development.md', 'modules/integration-patterns.md', 'modules/troubleshooting.md'), but the modules/ directory does not exist in the bundle — only references/examples.md and references/reference.md are present. Navigation to the primary detailed content is broken, matching anchor 2 (minimal structure / broken references), not 1 since the body itself has clear timed sections and no nested-reference chains. | 2 / 5 |
Total | 10 / 20 Passed |