CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

worktrunk

Guidance for Worktrunk (the `wt` CLI) — git worktree management, hooks, and config. Load when working out which worktree a `wt` command will act on, or reaching for the global `-C <path>` to target one; editing .config/wt.toml or ~/.config/worktrunk/config.toml; adding, modifying, or debugging hooks (post-merge, post-start, pre-commit, pre-merge, post-switch, etc.); configuring commit message generation or command aliases; or troubleshooting wt behavior. Also answers general worktrunk/wt questions.

Quality

97%

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

The canonical home for this skill is worktrunk in max-sixty/worktrunk

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tightly written operational guide: dense tool-specific rules (worktree resolution, two config scopes, the approvals security model), copy-paste commands with annotated good/bad examples, workflows with explicit verification steps, and a task-indexed set of one-level-deep references. The only slack is mild repetition inside the hook-approvals section, where the trust rationale is stated three times over.

Suggestions

Trim the repeated trust rationale in 'Hook approvals in non-interactive sessions': 'an untrusted `.config/wt.toml` cannot silently execute anything' and 'neither is a shortcut for an interactive agent to silence an approval prompt' each restate the point of the immediately preceding sentences — state it once and cut the restatements.

Deduplicate the approvals persistence detail: 'Run once per project; the approval persists across invocations until the command template changes or the project moves' repeats the earlier 're-prompted whenever a command template changes or the project moves' — keep one formulation.

In the same section, the opening three sentences ('Worktrunk never runs a project's hooks...' → 'an untrusted `.config/wt.toml` cannot silently execute anything') can be compressed to two: the mechanism (per-command approval on first run) plus the reason (arbitrary shell code from a freshly cloned repo).

DimensionReasoningScore

Conciseness

The body is lean and example-driven with no tutoring on concepts Claude already knows (no 'what is a worktree' padding), but the 'Hook approvals in non-interactive sessions' section restates its point several times: "an untrusted `.config/wt.toml` cannot silently execute anything" repeats the section's opening two sentences, "neither is a shortcut for an interactive agent to silence an approval prompt" repeats the preceding sentence, and "Run once per project; the approval persists across invocations until the command template changes or the project moves" duplicates "re-prompted whenever a command template changes". These are minor instances of over-explanation that could be trimmed (anchor 4), not 'every token earns its place' (anchor 5); it is well above anchor 3 ('some unnecessary explanation') since the repetition is confined to one deliberately emphatic security section.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: `wt step diff --branch beta` / `wt -C ../repo.beta step diff --branch beta` with ✓/✗ annotations for the targeting rules; `which claude codex opencode llm aichat`; `wt step commit --dry-run` as the verification step; complete TOML hook blocks for both pipeline and concurrent forms; `wt switch --create test-hooks`; `wt config approvals add`; `wt switch --create <branch> --no-cd`; and a literal sub-Agent prompt template ("You are working in `/abs/path/to/myproject.<branch>`..."). Specific examples cover the common cases — matching the anchor-5 example rather than anchor 4's 'minor gaps'.

5 / 5

Workflow Clarity

The two core workflows are clearly sequenced with explicit validation checkpoints: commit-message generation runs detect → propose the `[commit.generation]` change → apply after approval → "verify... `wt step commit --dry-run` renders the prompt, runs the LLM, and prints the message without committing"; hook configuration runs pick hook type by timing → derive commands from project files (package.json/Cargo.toml/pyproject.toml) → "verify they run before adding them" → "Test with `wt switch --create test-hooks`". The approvals section is a complete error→diagnosis→resolution loop, showing the literal error output and correctly steering the agent to escalate rather than use either `--yes` path. Checkpoints are present (not merely 'most'), so anchor 5 fits better than anchor 4.

5 / 5

Progressive Disclosure

The body is an overview with well-signaled, one-level-deep references: an "Available documentation" index annotating each file ("reference/config.md: User and project configuration (LLM, hooks, command defaults)" ... "reference/extending.md: Aliases, multi-step pipelines, custom subcommands, and template-expansion gotchas"), plus a "Common tasks reference" mapping tasks to files with section anchors (`reference/extending.md#aliases`, `reference/config.md#worktree-path-template`, `reference/llm-commits.md#prompt-templates`). No nested reference chains; detail is appropriately split out. (No bundle files were present in the review directory to verify the `reference/*.md` files exist, so this is scored on the body's reference structure alone.) This matches the anchor-5 'clear overview with well-signaled one-level-deep references; easy navigation' better than anchor 4's 'minor organization gaps'.

5 / 5

Total

19

/

20

Passed

Description

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

An exemplary description: it states what the skill covers (worktree management, hooks, and config for the `wt` CLI) and gives an explicit, multi-condition 'Load when...' clause (command targeting, `-C <path>`, config file edits, hook work, commit generation, aliases, troubleshooting, general questions). Trigger terms are natural, tool-specific, and include synonyms and concrete file paths, keeping conflict risk minimal.

DimensionReasoningScore

Specificity

Quotes: "git worktree management, hooks, and config", "working out which worktree a `wt` command will act on, or reaching for the global `-C <path>` to target one", "editing .config/wt.toml or ~/.config/worktrunk/config.toml", "adding, modifying, or debugging hooks (post-merge, post-start, pre-commit, pre-merge, post-switch, etc.)", "configuring commit message generation or command aliases", "troubleshooting wt behavior". These are multiple specific concrete actions and named config targets covering the tool's full surface (targeting, config, hooks, commit generation, aliases, troubleshooting) — the comprehensive anchor, not 'several actions with minor gaps'.

5 / 5

Completeness

What: "Guidance for Worktrunk (the `wt` CLI) — git worktree management, hooks, and config"; when: "Load when working out which worktree a `wt` command will act on, or reaching for the global `-C <path>`...; editing...; adding, modifying, or debugging hooks...; configuring commit message generation or command aliases; or troubleshooting wt behavior". Both what and when are explicit, and the when clause enumerates concrete trigger conditions — the anchor-5 pattern, clearly above anchor 4 ('when could be more explicit').

5 / 5

Trigger Term Quality

Quotes: "Worktrunk (the `wt` CLI)", "worktree", "`-C <path>`", ".config/wt.toml", "hooks", "commit message generation", "command aliases", "troubleshooting wt behavior", "general worktrunk/wt questions". Natural terms users of this tool would actually say are covered comprehensively, including synonyms (Worktrunk / wt / worktrunk / worktree) and concrete file paths and flags — matching the 'including synonyms and file extensions' anchor rather than merely 'good coverage with a few missing'.

5 / 5

Distinctiveness Conflict Risk

Quotes: "Worktrunk (the `wt` CLI)", ".config/wt.toml", "~/.config/worktrunk/config.toml", "wt behavior", "worktrunk/wt questions". Every trigger is tied to a named niche tool and its specific config files and commands, giving a clear niche with minimal conflict risk; the only generic phrase ("git worktree management") is a domain descriptor, not a load trigger, so this fits anchor 5 better than anchor 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

20

/

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

max-sixty/worktrunk

Path

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