CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-workflow-worktree

Git worktree management for parallel SPEC development with isolated workspaces, automatic branch registration, and seamless MoAI-ADK integration. Use when setting up parallel development environments.

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/moai-workflow-worktree/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

73%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid, third-person description that names its niche clearly and includes an explicit 'Use when' clause. Its main weaknesses are generic action language (no concrete verbs like create, sync, or remove worktrees), buzzword padding ('seamless integration'), and a when-clause that could name more concrete triggers.

Suggestions

Replace generic nouns with concrete actions, e.g. 'Creates isolated git worktrees per SPEC, syncs them with the base branch, and cleans up merged worktrees'.

Add concrete trigger phrases to the 'Use when' clause, such as 'when the user wants to develop multiple SPECs in parallel, isolate experimental branches, or run teammate sessions in separate worktrees'.

Drop buzzword padding like 'seamless' and 'automatic branch registration' in favor of the actual commands or behaviors.

DimensionReasoningScore

Specificity

The domain is named and capabilities enumerated ('isolated workspaces, automatic branch registration'), but the only actions are generic nouns ('management', 'integration') with no concrete verbs, and 'seamless MoAI-ADK integration' is buzzword padding. Fits between anchor 2 (minimal/generic actions) and anchor 3; the capability list keeps it at 3.

3 / 5

Completeness

Both parts are explicit: the 'what' ('Git worktree management for parallel SPEC development with isolated workspaces...') and the 'when' ('Use when setting up parallel development environments'). Not 5 because the when-clause is broad and lacks concrete trigger phrases; not 3 because the when is explicitly stated rather than merely implied.

4 / 5

Trigger Term Quality

Natural terms users would say are present ('Git worktree', 'parallel SPEC development', 'isolated workspaces', 'parallel development environments'), but common variations like 'multiple branches', 'concurrent', or 'isolation' as a standalone trigger are missing. Matches anchor 4 (good coverage, a few natural terms missing), not 5 which requires synonym/extension comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche — worktree management for MoAI-ADK parallel SPEC development — which is clearly distinguishable from generic git or workflow skills, with distinct triggers and minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/moai-workflow-worktree/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.