CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

47

Quality

51%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-sectioned and contains one strong, executable section (--team flag with a decision matrix and failure modes), but it is heavily padded with concepts Claude already knows and renders its core CLI command reference as prose without executable syntax. Progressive disclosure is undermined by five module references that point to non-existent files.

Suggestions

Cut the conceptual padding (Core Philosophy, Key Features, Parallel Development Benefits) and convert the section-2 prose command descriptions into a compact executable command table with real syntax (e.g., `moai worktree new <SPEC-ID> <desc>`).

Add explicit validation checkpoints to the parallel-development workflow, especially a validate-before-clean/remove feedback loop for the destructive batch operations.

Either create the referenced modules/*.md files or remove/fix the five dead 'Refer to ... Module at modules/...' links so navigation matches the actual bundle (references/examples.md, references/reference.md).

DimensionReasoningScore

Conciseness

The ~315-line body explains concepts Claude already knows ('Core Philosophy', 'Parallel Development Benefits: Context Isolation: Each SPEC has its own Git state', 'Key Features' restating the description) and renders CLI commands as prose ('To create a new worktree for a SPEC, use the new command followed by the SPEC ID and description. To list all worktrees, use the list command...'), matching the level-1 'verbose; explains concepts Claude knows; padded with unnecessary context'; it is not level 2 because the padding is pervasive rather than occasional, even though section 5 contains tight executable blocks.

1 / 3

Actionability

Section 5 provides fully executable bash and a concrete decision matrix, but the core CLI Commands section (section 2) describes eight commands in prose with no executable syntax, and the Example Workflow (section 3) narrates ('create a worktree for SPEC-001 with a description like User Authentication') instead of showing commands, matching level-2 'some concrete guidance but incomplete; missing key details'; not level 3 because the primary command reference lacks copy-paste-ready syntax, and not level 1 because section 5 and the verification checklist supply real executable guidance.

2 / 3

Workflow Clarity

The Plan/Development/Sync/Cleanup phases are sequenced and a Verification checklist plus section-5 failure-mode fallbacks provide some checkpoints, but the core parallel-development workflow (sections 3-4) has no inline validation checkpoints and destructive/batch operations (clean, remove) lack an explicit validate-before-act feedback loop, which per the rubric caps workflow clarity at 2; not level 3 because checkpoints are not woven through the main workflow, and not level 1 because a clear sequence and a checklist are present.

2 / 3

Progressive Disclosure

The body is sectioned and signals references ('Refer to Worktree Commands Module at modules/worktree-commands.md', plus modules/worktree-management, parallel-development, integration-patterns, troubleshooting), but the actual bundle contains only references/examples.md and references/reference.md — the five modules/*.md paths are dead/non-existent — and substantial reference-style content is inline, matching level-2 'references present but not clearly signaled; content that should be separate is inline'; not level 3 because navigation is broken by the missing module files, and not level 1 because the body is organized into sections with one-level (not nested) references rather than a monolithic wall.

2 / 3

Total

7

/

12

Passed

Description

67%

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

The description answers both what and when with an explicit 'Use when' clause, but its capabilities are nominalized rather than action-verb concrete and its trigger terms blend natural keywords with product-specific jargon. Distinctiveness is moderate: the worktree niche is clear yet the activation trigger is generic enough to risk overlap.

Suggestions

Rewrite capabilities as concrete action verbs (e.g., 'Create, switch, sync, and clean isolated git worktrees for parallel SPEC development') to lift specificity toward the level-3 anchor.

Add common natural trigger variations ('git worktree', 'feature branches', 'parallel branches', 'multiple worktrees') and de-emphasize product jargon like 'MoAI-ADK' in the user-facing trigger clause.

Sharpen the 'Use when' clause to a more distinctive trigger (e.g., 'Use when developing multiple SPECs in parallel and needing isolated git worktrees per SPEC') to reduce overlap with generic parallel-development skills.

DimensionReasoningScore

Specificity

Quotes 'Git worktree management for parallel SPEC development with isolated workspaces, automatic branch registration, and seamless MoAI-ADK integration' name the domain and several capabilities, but they are nominalized (management, registration, integration) rather than concrete action verbs and omit the actual operations (create/list/sync/remove/clean); not the level-3 anchor's 'multiple specific concrete actions' like 'Extract... fill... merge', and above level 1 because it does name concrete capabilities rather than vague abstraction.

2 / 3

Completeness

The description states what ('Git worktree management for parallel SPEC development with isolated workspaces, automatic branch registration, and seamless MoAI-ADK integration') and explicitly when ('Use when setting up parallel development environments'), satisfying the level-3 anchor that requires both an explicit what and an explicit 'Use when' trigger; it is not level 2 because the when-clause is present and explicit, not merely implied.

3 / 3

Trigger Term Quality

Natural terms a user would say appear ('Git worktree', 'parallel development', 'isolated workspaces'), but they are mixed with product jargon ('SPEC development', 'MoAI-ADK integration') and miss common variations like 'feature branches' or 'multiple branches'; matches the level-2 'some relevant keywords but missing common variations' rather than level 3's broad natural coverage, and above level 1 because real user-facing terms are present.

2 / 3

Distinctiveness Conflict Risk

'Git worktree management' is a recognizable niche, but the trigger 'setting up parallel development environments' is generic and could overlap with other dev-environment or parallel-development skills, matching the level-2 'somewhat specific but could still overlap'; not level 3 because the when-trigger is not sharply distinctive, and not level 1 because the worktree framing is clearly more specific than 'helps with code and documents'.

2 / 3

Total

9

/

12

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.

Validation14 / 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
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.