hellblazer/git-worktrees
nx/skills/git-worktrees/SKILL.md
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
$ install --global
skillsauthnpx skillsauth add hellblazer/nexus git-worktreesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 7:44 AM1.4s1 file scanned
SKILL.md
- name:
- git-worktrees
- description:
- Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
- effort:
- medium
Git Worktrees
Git worktrees create isolated workspaces sharing the same repository.
Directory Selection (priority order)
- Check existing:
.worktrees/(preferred) orworktrees/ - Check CLAUDE.md for worktree directory preference
- Ask user:
.worktrees/(project-local, hidden) or~/.config/nexus/worktrees/<project>/(global)
Safety: Verify Ignored
Before creating project-local worktrees:
git check-ignore -q .worktrees 2>/dev/null
If NOT ignored: add to .gitignore and commit, then proceed.
Creation
project=$(basename "$(git rev-parse --show-toplevel)")
git worktree add "$path" -b "$BRANCH_NAME"
cd "$path"
Setup (auto-detect)
[ -f pyproject.toml ] && { command -v uv &>/dev/null && uv sync || pip install -e .; }
[ -f requirements.txt ] && ! [ -f pyproject.toml ] && pip install -r requirements.txt
[ -f package.json ] && npm install
[ -f Cargo.toml ] && cargo build
[ -f go.mod ] && go mod download
Verify baseline
Run project test suite. If tests fail: report failures, ask whether to proceed.
Branch Naming
Follow project convention. For beads-tracked work: feature/<bead-id>-<description>.
Agent Isolation
The Agent tool supports isolation: "worktree" natively — it creates a temporary git worktree automatically and cleans up if no changes are made. Prefer this for parallel agent work over manual worktree management.
Quick Reference
| Situation | Action |
|---|---|
| .worktrees/ exists | Use it (verify ignored) |
| worktrees/ exists | Use it (verify ignored) |
| Both exist | Use .worktrees/ |
| Neither exists | Check CLAUDE.md → ask user |
| Not ignored | Add to .gitignore + commit |
| Tests fail baseline | Report + ask |
| Parallel agents | Use isolation: "worktree" on Agent tool |
Pairs with: /nx:finishing-branch for merge/PR/cleanup after work is done.
Related Skills
hellblazer/review
development
VerifiedTrustedCommunity
Use when critiquing / auditing / reviewing a change set against decision history — tries the review plan library first (catalog lookup → decision-evolution traversal → extract → compare), falls through to /nx:query if nothing matches
1SKILL.mdUpdated Apr 17, 2026
hellblazer/research
documentation
VerifiedTrustedCommunity
Use when doing design / architecture / planning work that walks from prose (RDRs, docs, knowledge) into the modules implementing a concept
1SKILL.mdUpdated Apr 17, 2026
hellblazer/plan-promote
development
VerifiedTrustedCommunity
Use when surveying the plan library's runtime metrics to propose plans for promotion to a higher scope — advisory-only; dispatches the plan-promote-propose meta-seed (no lifecycle ops — those ship in RDR-079)
1SKILL.mdUpdated Apr 17, 2026
hellblazer/plan-inspect
business
VerifiedTrustedCommunity
Use when inspecting plan runtime metrics or enumerating dimension-registry usage — dispatches plan_match with dimensions={verb:plan-inspect}; strategy:default reports per-plan metrics, strategy:dimensions reports registry usage counts
1SKILL.mdUpdated Apr 17, 2026