Agent skill

git-worktree

Manage Git worktrees for parallel development

Stars 6
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/v1truv1us/ai-eng-system/tree/main/packages/cli/dist/skills/git-worktree

SKILL.md

Git Worktree Skill

Critical Importance

Using git worktrees properly is critical for your development workflow efficiency. Poor worktree management leads to confusion, lost work, merge conflicts, and cluttered repositories. Proper worktree use enables parallel development without context switching costs, but misuse compounds problems across branches. Clean, organized worktrees prevent disasters.

Systematic Approach

** approach worktree management systematically.** Worktrees require deliberate creation, clear naming, and timely cleanup. Don't create worktrees impulsively—plan your branching strategy, name worktrees descriptively, and establish cleanup habits. Treat worktrees as temporary workspaces that should be removed after merge, not permanent fixtures.

The Challenge

The maintain pristine worktree hygiene while juggling multiple parallel features, but if you can:

  • You'll eliminate merge conflict nightmares
  • Your git history will stay clean and readable
  • Parallel development will be frictionless
  • You'll never wonder "where did I put that branch?"

The challenge is balancing the freedom of parallel development with the discipline of cleanup. Can you leverage worktrees for productivity without drowning in stale branches?

Basic Commands

Create worktree: git worktree add ../project-feature -b feature/name List: git worktree list Remove: git worktree remove ../project-feature Best practices: name clearly, clean up after merge.

Worktree Confidence Assessment

After setting up or managing worktrees, rate your confidence from 0.0 to 1.0:

  • 0.8-1.0: Worktrees are well-named, properly organized, no stale branches present
  • 0.5-0.8: Worktrees functional but some naming inconsistencies or minor cleanup needed
  • 0.2-0.5: Multiple stale worktrees, unclear what's active, some confusion about branch state
  • 0.0-0.2: Worktree management is chaotic, risk of lost work or conflicts

Identify areas of uncertainty: Are there worktrees you don't recognize? Do you know which branches are still needed? What's the risk of worktree-related issues?

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

v1truv1us/ai-eng-system

incentive-prompting

Research-backed prompting techniques for improved AI response quality (+45-115% improvement). Use when optimizing prompts, enhancing agent instructions, or when maximum response quality is critical. Invoked by /ai-eng/optimize command. Includes expert persona, stakes language, step-by-step reasoning, challenge framing, and self-evaluation techniques.

6 1
Explore
v1truv1us/ai-eng-system

git-worktree

Manage Git worktrees for parallel development

6 1
Explore
v1truv1us/ai-eng-system

prompt-refinement

Transform prompts into structured TCRO format with phase-specific clarification. Automatically invoked by /ai-eng/research, /ai-eng/plan, /ai-eng/work, and /ai-eng/specify commands. Use when refining vague prompts, structuring requirements, or enhancing user input quality before execution.

6 1
Explore
v1truv1us/ai-eng-system

ralph-wiggum

Continuous iteration loop pattern for well-defined tasks with clear completion criteria. Use when getting tests to pass, implementing features with automatic verification, bug fixing with clear success conditions, or running automated development overnight. Provides prompt templates, safety guidelines, and integration patterns for ai-eng-system workflows.

6 1
Explore
v1truv1us/ai-eng-system

comprehensive-research

Multi-phase research orchestration for thorough codebase, documentation, and external knowledge investigation. Invoked by /ai-eng/research command. Use when conducting deep analysis, exploring codebases, investigating patterns, or synthesizing findings from multiple sources.

6 1
Explore
v1truv1us/ai-eng-system

plugin-dev

This skill should be used when creating extensions for Claude Code or OpenCode, including plugins, commands, agents, skills, and custom tools. Covers both platforms with format specifications, best practices, and the ai-eng-system build system.

6 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results