Agent skill

worktrunk

Git worktree management with Worktrunk CLI. Use when the user mentions git worktrees, parallel agents, running multiple Claude instances, branching workflows, or wants to create/switch/merge/remove worktrees. Helps with wt switch, wt list, wt merge, wt remove commands and hook configuration.

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/uriklar/.claude/tree/main/skills/worktrunk

SKILL.md

Worktrunk

Worktrunk uses branch names to address worktrees. Each worktree maps to exactly one branch; paths derive automatically.

Core Commands

wt switch

Navigate between or create worktrees.

bash
wt switch feat              # Switch to existing worktree
wt switch -c feat           # Create new worktree/branch
wt switch -c feat -b main   # Create from specific base branch
wt switch -c feat -x claude # Create and launch Claude

Shortcuts: ^ (default branch), @ (current), - (previous)

Key flags:

  • -c, --create — Create new branch/worktree
  • -b, --base <BRANCH> — Base branch (default: repo default)
  • -x, --execute <CMD> — Run command after switch
  • -y, --yes — Skip prompts
  • --no-verify — Skip hooks

wt list

Show all worktrees with status.

bash
wt list                     # Basic listing
wt list --full              # Include CI status, line diffs
wt list --format json       # JSON output for scripting
wt list --branches          # Include branches without worktrees

Status symbols: Staged, modified, untracked, conflicts, ahead/behind

wt merge

Merge feature branch to default (squash + rebase + merge + cleanup).

bash
wt merge                    # Merge current to default branch
wt merge develop            # Merge to specific branch
wt merge --no-squash        # Keep individual commits
wt merge --no-remove        # Keep worktree after merge
wt merge --no-commit        # Stage but don't commit

Pipeline: squash → rebase → pre-merge hooks → merge → cleanup → post-merge hooks

wt remove

Clean up worktree and branch.

bash
wt remove                   # Remove current worktree
wt remove feat              # Remove specific worktree

Common Workflows

Start a new Claude agent on a feature

bash
wt switch -c feature-name -x claude
# Or with alias:
alias wsc='wt switch --create -x claude'
wsc fix-bug -- 'Fix issue #123'

Complete and merge work

bash
wt merge                    # Squash, merge to main, cleanup

Manage parallel agents

bash
wt list --full              # See all agents with status
wt switch other-feature     # Jump to another worktree

Hooks

Configure project hooks with wt hook:

  • post-create — Run after worktree creation (e.g., install deps)
  • pre-merge — Run before merge (e.g., tests)
  • post-merge — Run after merge completes

Use --no-verify on any command to skip hooks.

Expand your agent's capabilities with these related and highly-rated skills.

uriklar/.claude

markdown-slides

Create presentation slides from markdown with an iterative workflow. Use when the user wants to: (1) Create a slide deck or presentation in markdown format (2) Build slides iteratively, one at a time (3) Generate HTML output from markdown slides Workflow: Create skeleton → iterate over each slide → user says "commit!" to save. Outputs CommonMark-compliant markdown that converts to styled HTML.

0 0
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results