worktree-detection

What problem does it solve?

This Skill solves the problem of locating a specific Git worktree for a given task number without relying on hardcoded directory paths.

Core Features & Use Cases

• Worktree discovery by task identifier: Locates the correct worktree path by matching the task number embedded in git worktree list output.
• Hook/script friendly behavior: Exits cleanly with a skip message when no matching worktree exists, avoiding failures during automated runs.
• Flexible task number extraction: Derives TASK_NUM from TASK_OWNER and TASK_SUBJECT using a TASK-\d+ pattern so it works across varying agent variable formats.

Quick Start

In your hook or automation script, set TASK_NUM to the task you want (for example TASK-005) and run the detection snippet to resolve the matching worktree path or skip if none exists.