skills.rest
smykla-skalski
smykla-skalskiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

worktree-review

Validate Git worktree symlinks, excludes, and branch tracking.

3|1|Updated Feb 12, 2026
Search Tags:#git#debugging#validation#configuration#worktree#symlinks
One-click install
npx skills add https://github.com/smykla-skalski/sai --skill worktree-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worktree-review
Source: https://github.com/smykla-skalski/sai/tree/main/git/skills/worktree-review
Command: npx skills add https://github.com/smykla-skalski/sai --skill worktree-review

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill prevents common issues in Git worktrees by automatically validating critical configurations like symlinks, Git excludes, and branch tracking, ensuring a stable and error-free development environment.

Core Features & Use Cases

  • Symlink Integrity: Verifies that all necessary symlinks exist and point to the correct targets, preventing broken links.
  • Git Excludes Configuration: Ensures that symlinked files are correctly excluded from Git tracking to avoid accidental commits.
  • Branch Tracking Validation: Confirms that worktrees are properly linked to their upstream branches.
  • Use Case: After creating a new Git worktree for a feature branch, run this Skill to confirm that all essential configuration files and symlinks are correctly set up before you start coding.

Quick Start

Run the worktree-review skill to validate the current directory's Git worktree setup.

Frequently Asked Questions about worktree-review

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

FAQPage Schema
How do I validate my git worktree configuration before starting work?▼

To validate a git worktree configuration, you can run an automated check to verify symlink integrity, Git excludes, and upstream branch tracking, ensuring a stable development environment before coding.

Why does my git worktree have broken symlinks and how can I fix them?▼

Broken symlinks in a git worktree are caused by missing or incorrect link targets. Validating symlink integrity identifies these broken links so you can prevent configuration errors and fix the paths.

Does git worktree validation check if symlinked files are excluded from tracking?▼

Yes, git worktree validation checks Git excludes to ensure that symlinked files are correctly excluded from Git tracking, preventing accidental commits of worktree-specific files.

How do I verify upstream branch tracking in a git worktree?▼

To verify upstream branch tracking in a git worktree, run a branch tracking validation to confirm that your worktree is properly linked to its correct upstream branch.

Can I use Bash and Glob tools to check git worktree setup?▼

Yes, you can use Bash, Read, and Glob tools to execute file system and Git commands for checking git worktree setup, including symlink targets and branch tracking status.

What is the best way to prevent accidental commits of worktree-specific files?▼

The best way to prevent accidental commits of worktree-specific files is to validate Git excludes configuration, ensuring that symlinked files are properly ignored by Git tracking.

Related Skills

Explore More Software Engineering Skills→
cenmiaocenmiao

openspec-sp-git-worktree

Create isolated Git worktrees with branch naming and baseline tests.

Community
Intermediate
f4irlinef4irline
5

git-worktree-prepare

Create or reuse isolated git worktrees for target branches.

Community
Advanced
juanandresgsjuanandresgs
191

diagnose

Validates hook integrity, state files, and Git health for Claude Code configuration.

Community
Intermediate
homeassistant-aihomeassistant-ai
4.3k

wt

Create a git worktree under worktree/<branch> and update submodules.

Official
Intermediate