Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs: document the Claude Code configuration skill (#477)

Maximilian Roos8d56331210a8
diff --git a/.claude-plugin/skills/worktrunk/reference/claude-code.md b/.claude-plugin/skills/worktrunk/reference/claude-code.md
index b2863c023..04fd0f293 100644
--- a/.claude-plugin/skills/worktrunk/reference/claude-code.md
+++ b/.claude-plugin/skills/worktrunk/reference/claude-code.md
@@ -1,10 +1,31 @@
# Claude Code Integration
-Worktrunk includes a Claude Code plugin that automatically tracks which worktrees have active Claude sessions. When Claude starts working in a worktree, the plugin sets a status marker; when Claude waits for input, the marker updates. This makes it easy to monitor multiple parallel agents from `wt list`.
+The worktrunk Claude Code plugin provides two features:
-## Status tracking
+1. **Configuration skill** — Documentation Claude Code can read, so it can help set up LLM commits, hooks, and troubleshoot issues
+2. **Activity tracking** — Status markers in `wt list` showing which worktrees have active Claude sessions (🤖 working, 💬 waiting)
-The plugin adds status indicators to `wt list`:
+## Installation
+
+```bash
+$ claude plugin marketplace add max-sixty/worktrunk
+$ claude plugin install worktrunk@worktrunk
+```
+
+## Configuration skill
+
+The plugin includes a skill — documentation that Claude Code can read — covering worktrunk's configuration system. After installation, Claude Code can help with:
+
+- Setting up LLM-generated commit messages
+- Adding project hooks (post-create, pre-merge, pre-commit)
+- Configuring worktree path templates
+- Fixing shell integration issues
+
+Claude Code is designed to load the skill automatically when it detects worktrunk-related questions.
+
+## Activity tracking
+
+The plugin tracks Claude sessions with status markers in `wt list`:
<span class="prompt">$</span> <span class="cmd">wt list</span>
<b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>Path</b> <b>Remote⇅</b> <b>Commit</b> <b>Age</b> <b>Message</b>
@@ -18,13 +39,6 @@ The plugin adds status indicators to `wt list`:
- 🤖 — Claude is working
- 💬 — Claude is waiting for input
-### Installation
-
-```bash
-$ claude plugin marketplace add max-sixty/worktrunk
-$ claude plugin install worktrunk@worktrunk
-```
-
### Manual status markers
Set status markers manually for any workflow:
diff --git a/docs/content/claude-code.md b/docs/content/claude-code.md
index f429dc977..8989d5d43 100644
--- a/docs/content/claude-code.md
+++ b/docs/content/claude-code.md
@@ -6,11 +6,32 @@ weight = 23
group = "Reference"
+++
-Worktrunk includes a Claude Code plugin that automatically tracks which worktrees have active Claude sessions. When Claude starts working in a worktree, the plugin sets a status marker; when Claude waits for input, the marker updates. This makes it easy to monitor multiple parallel agents from `wt list`.
+The worktrunk Claude Code plugin provides two features:
-## Status tracking
+1. **Configuration skill** — Documentation Claude Code can read, so it can help set up LLM commits, hooks, and troubleshoot issues
+2. **Activity tracking** — Status markers in `wt list` showing which worktrees have active Claude sessions (🤖 working, 💬 waiting)
-The plugin adds status indicators to `wt list`:
+## Installation
+
+```bash
+$ claude plugin marketplace add max-sixty/worktrunk
+$ claude plugin install worktrunk@worktrunk
+```
+
+## Configuration skill
+
+The plugin includes a skill — documentation that Claude Code can read — covering worktrunk's configuration system. After installation, Claude Code can help with:
+
+- Setting up LLM-generated commit messages
+- Adding project hooks (post-create, pre-merge, pre-commit)
+- Configuring worktree path templates
+- Fixing shell integration issues
+
+Claude Code is designed to load the skill automatically when it detects worktrunk-related questions.
+
+## Activity tracking
+
+The plugin tracks Claude sessions with status markers in `wt list`:
<!-- ⚠️ AUTO-GENERATED-HTML from tests/snapshots/integration__integration_tests__list__list_with_user_marker.snap — edit source to update -->
@@ -30,13 +51,6 @@ The plugin adds status indicators to `wt list`:
- 🤖 — Claude is working
- 💬 — Claude is waiting for input
-### Installation
-
-```bash
-$ claude plugin marketplace add max-sixty/worktrunk
-$ claude plugin install worktrunk@worktrunk
-```
-
### Manual status markers
Set status markers manually for any workflow: