skills.rest
bossjones
bossjonesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

worktree-doctor

Analyze Git repository files and suggest .worktreeinclude configurations.

1|Updated Jan 4, 2026
Search Tags:#git#worktree#configuration management#repository management#project isolation
One-click install
npx skills add https://github.com/bossjones/boss-skills --skill worktree-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worktree-doctor
Source: https://github.com/bossjones/boss-skills/tree/main/plugins/boss-dev/agent-harness/skills/worktree-doctor
Command: npx skills add https://github.com/bossjones/boss-skills --skill worktree-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The need to configure .worktreeinclude properly in repositories where worktrees are being set up, to ensure the worktrees have all the necessary local configuration and secret files.

Core Features & Use Cases

  • Environment Variable & Secret Scanning: Identify files such as .env, .env.* or .envrc to include in worktree environments.
  • Project Type Detection: Determine project type (e.g., Python, Node) from .gitignore to add appropriate config files.
  • Worktree Ignore Checking: Ensure that .claude/worktrees/ is correctly ignored in the main gitignore.

Quick Start

Analyze and get a suggestion for .worktreeinclude for the current repo.

Frequently Asked Questions about worktree-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure .worktreeinclude files for local secrets and config in a Git worktree?▼

To configure .worktreeinclude files, this Skill analyzes your local repository files and suggests inclusions for local config, secrets like .env files, and project markers to ensure proper worktree settings without manual file additions.

Can I automatically detect environment variables and .envrc files for my Git worktree setup?▼

Yes, environment variable and secret scanning identifies files such as .env, .env.* or .envrc to include in worktree environments, ensuring local secrets are available across your worktree configurations.

What is the best way to ensure project isolation includes Python or Node config files in Git worktrees?▼

Project type detection determines your project type, such as Python or Node, from .gitignore to add appropriate config files automatically, supporting optimal project isolation within your worktree directories.

Does Git worktree isolation require manually adding local configuration files to each branch?▼

No, Git worktree isolation does not require manual file additions. The Skill analyzes local files and suggests .worktreeinclude configurations to support various workflow settings automatically.

How do I check if .claude/worktrees/ is correctly ignored in my main .gitignore?▼

Worktree ignore checking ensures that .claude/worktrees/ is correctly ignored in the main gitignore, verifying that your worktree directories are properly excluded from version control tracking.

Related Skills

Explore More Software Engineering Skills→
alexanderopalexanderop

using-git-worktrees

Create isolated git worktrees for feature branches with safety checks.

Community
Advanced
jr2804jr2804

using-git-worktrees

Automates creation of isolated Git worktrees for feature development.

Community
Intermediate
jbrojbro

using-git-worktrees

Create isolated git worktrees and verify baseline tests.

Community
Advanced
KenTaniguchi-RKenTaniguchi-R

Pier CLI Tool Management

Add, edit, and remove Pier CLI tools via conversational prompts.

Community
Intermediate