CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workforest

This skill should be used when the user asks about 'workforest', 'git forest', 'git forest list', 'git forest add', 'git forest remove', 'forest layout', or mentions managing worktrees with workforest. Also use when the user asks how workforest works, how to use git forest commands, or how to navigate a forest.

63

Quality

79%

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 ./plugins/git-workforest/skills/workforest/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A lean, highly actionable reference for the git-forest CLI: executable examples with expected outputs for the common add/remove/list operations and a clear helper-behavior section. Its main weaknesses are redundant restatements of the forest-root concept and a few missing verification steps.

Suggestions

State the forest-root/.workforest.yaml definition once (in 'Forest layout') and drop the repeats in 'Detecting a forest', 'Adding and removing trees', and 'Working in a forest'.

Add a brief verification cue after `git forest add` (e.g., run `git forest list` to confirm the new tree) to strengthen workflow checkpoints.

Move or trim the list-output color/sorting conventions if they are secondary to the helper workflow.

DimensionReasoningScore

Conciseness

The forest-root/.workforest.yaml definition is restated four times across 'Detecting a forest', 'Forest layout', 'Adding and removing trees', and 'Working in a forest', and the cd-to-switch guidance appears twice. This matches anchor 3 ('mostly efficient but could be tightened') rather than anchor 4, where over-explanation would be only minor.

3 / 5

Actionability

Copy-paste-ready commands cover the common cases: the command table gives full syntax, and `git forest add`/`remove` examples show concrete resulting paths, expected printed output, and dirty-refusal behavior, with a sample `git forest list` output. This matches anchor 5 ('fully executable; specific examples cover the common cases').

5 / 5

Workflow Clarity

'When helping users in a forest' sequences the helper workflow (list to understand layout, prefer add over checkout, remind to cd), and the destructive `remove` documents its validation behavior ('refuses if dirty', '-f' for uncommitted changes). Minor gaps remain (e.g., no step to verify a tree was created after add), fitting anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Well-organized sections with no bundle files and nothing that clearly demands splitting at ~90 lines, though the list-output color-convention detail and the repeated root-definition sections are minor organization gaps. The under-50-line exception to score 5 does not apply to this body length, so anchor 4 fits best.

4 / 5

Total

16

/

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 strong, highly explicit trigger description for a well-defined niche, weakened by never stating what workforest actually does. Adding a one-line capability statement (e.g., 'Manages git worktrees with a predictable folder structure') would lift both specificity and completeness.

Suggestions

Open with a concrete capability statement in third person, e.g., 'Manages git worktrees with a simple, predictable folder structure; each branch gets its own directory.'

State the 'what' outside the when-clause so completeness doesn't depend on inference from 'managing worktrees with workforest'.

Add one or two natural trigger variations users might say, such as 'add a tree' or 'set up a forest'.

DimensionReasoningScore

Specificity

The description names the domain (workforest, git forest commands) and lists command names ('git forest list', 'git forest add', 'git forest remove'), but its only capability statement is the generic 'managing worktrees with workforest' — it sits just above anchor 2's minimal-actions example ('Processes PDF files') without describing what any command actually does.

3 / 5

Completeness

The 'when' is maximally explicit ('This skill should be used when the user asks about...'), but the 'what' is only weakly implied inside the when-clause ('managing worktrees with workforest') rather than stated as a capability. This matches anchor 4 (both present, one could be stronger) and is clearly above anchor 3, which requires a clear 'what' with a missing 'when'.

4 / 5

Trigger Term Quality

Natural, tool-specific trigger phrases ('workforest', 'git forest', 'forest layout', 'how to navigate a forest') match what a user would genuinely say, but a few natural variations (e.g., 'worktrees' alone, 'add a tree') are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers — the worktree trigger is qualified as 'managing worktrees with workforest', minimizing collision with plain git-worktree skills. Minimal conflict risk, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dwmkerr/git-workforest

Path

plugins/git-workforest/skills/workforest/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.