worktrunk

The worktrunk skill provides guidance and documentation support for Worktrunk, a command-line tool built for managing Git worktrees, hooks, and related developer workflows. It helps users configure and troubleshoot the `wt` CLI, understand configuration scopes, and automate repository workflows using hooks and command settings. The skill is specifically designed to support editing Worktrunk configuration files, including user-level configuration in `~/.config/worktrunk/config.toml` and project-level configuration in `.config/wt.toml`. It also assists with setup workflows such as enabling commit message generation and debugging hook execution behavior.

The skill covers multiple areas of Worktrunk functionality, including worktree lifecycle hooks, shell integration, LLM-powered commit message generation, command aliases, and troubleshooting guidance. It references official Worktrunk documentation files for configuration, hooks, command usage, shell integration, and language-specific workflow patterns. The skill can guide users through common setup procedures such as detecting installed LLM tools, configuring commit generation commands, creating and updating configuration files, and validating generated prompts or merge workflows. It also helps distinguish between user-specific configuration and team-wide project automation.

This skill is intended for developers and engineering teams who use Worktrunk to manage Git worktrees and automate development workflows. It is particularly useful for teams implementing shared hooks, developers customizing local environments, and users integrating AI-assisted commit generation into their Git workflows. The skill supports troubleshooting and onboarding scenarios where developers need structured guidance for configuring Worktrunk behavior across personal and project contexts.