jankneumann/worktree
skills/worktree/SKILL.md
Worktree lifecycle management scripts — setup, teardown, heartbeat, pin, GC, merge
$ install --global
skillsauthnpx skillsauth add jankneumann/agentic-coding-tools worktreeInstall 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: May 22, 2026, 7:14 AM126.1s9 files scanned
SKILL.md
- name:
- worktree
- description:
- Worktree lifecycle management scripts — setup, teardown, heartbeat, pin, GC, merge
- category:
- Infrastructure
- tags:
- [worktree, git, infrastructure, merge]
- user_invocable:
- false
Worktree Infrastructure Skill
Non-user-invocable infrastructure skill that bundles worktree lifecycle management scripts. Referenced by SDLC skills via sibling-relative paths.
Scripts
scripts/worktree.py
Git worktree lifecycle manager for the launcher invariant (shared checkout is read-only).
Usage:
python3 "<skill-base-dir>/scripts/worktree.py" <command> [args]
Commands:
| Command | Arguments | Description |
|---------|-----------|-------------|
| setup | <change-id> [--agent-id ID] | Create worktree at .git-worktrees/<change-id>/ |
| teardown | <change-id> [--agent-id ID] | Remove worktree and clean branch |
| status | <change-id> [--agent-id ID] | Print worktree path and branch |
| detect | | Auto-detect if CWD is inside a worktree |
| heartbeat | <change-id> [--agent-id ID] | Update last-active timestamp (prevents GC) |
| list | | List all registered worktrees |
| pin | <change-id> | Protect worktree from GC |
| unpin | <change-id> | Remove GC protection |
| gc | [--force] | Garbage collect stale worktrees (24h default) |
Stdout (setup): WORKTREE_PATH=<path>, BRANCH_CREATED=<branch>, CREATED=true|false
Exit codes: 0 = success, 1 = error
scripts/merge_worktrees.py
Merges parallel agent branches into the feature branch.
Usage:
python3 "<skill-base-dir>/scripts/merge_worktrees.py" <change-id> <pkg-id>... [--json]
Arguments:
<change-id>— Feature change ID<pkg-id>...— One or more package IDs to merge--json— Output merge results as JSON
Exit codes: 0 = all merged, 1 = conflict or error
scripts/git-parallel-setup.sh
Configures local git for parallel agent development (rerere, zdiff3, histogram diff).
Usage:
bash "<skill-base-dir>/scripts/git-parallel-setup.sh"
Related Skills
jankneumann/review-artifacts
development
VerifiedTrustedCommunity
Open the artifacts relevant to a review (OpenSpec proposal, branch changes, or explicit paths) in VS Code, in a curated read-order, in the right worktree.
4SKILL.mdUpdated May 24, 2026
jankneumann/coordinator-task-status-renderer
tools
VerifiedTrustedCommunity
Render and seed coordinator-owned task status block in OpenSpec tasks.md
4SKILL.mdUpdated May 17, 2026
jankneumann/missing-tail-block
testing
VerifiedTrustedCommunity
User-invocable skill that omits the tail block
4SKILL.mdUpdated May 15, 2026
jankneumann/missing-keys
tools
VerifiedTrustedCommunity
Missing several required keys
4SKILL.mdUpdated May 15, 2026