aufrank/parallelizing-with-worktrees
skills/parallelizing-with-worktrees/SKILL.md
Create and manage Git worktrees to parallelize agent tasks safely. Use when you need multiple concurrent checkouts (sub-agents, parallel edits, or isolated experiments) and want deterministic setup/cleanup with manifests and logs.
testing
Updated Apr 3, 2026
$ install --global
skillsauthnpx skillsauth add aufrank/agent-skills parallelizing-with-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 20, 2026, 3:20 PM1.8s1 file scanned
SKILL.md
- name:
- parallelizing-with-worktrees
- description:
- Create and manage Git worktrees to parallelize agent tasks safely. Use when you need multiple concurrent checkouts (sub-agents, parallel edits, or isolated experiments) and want deterministic setup/cleanup with manifests and logs.
Parallelizing With Worktrees
Overview
Create isolated worktrees per task so parallel agents can edit, test, and commit without colliding. Use the scripts to generate a manifest, inspect status, and clean up deterministically.
Quick start
- Write a task list file (one task per line, optional
task:branch). - Run
scripts/create_worktrees.pyto create worktrees and a manifest. - Dispatch sub-agents to the worktree paths in the manifest.
- Use
scripts/status_worktrees.pyto inspect state. - Use
scripts/cleanup_worktrees.pyto remove worktrees when done.
Core Guidance
- Confirm with the user before creating or removing worktrees (filesystem changes).
- Keep worktrees outside the repo root to avoid nesting; default root is
../<repo>-worktrees/<run-id>. - Prefer
mode=branchfor real edits; usemode=detachfor read-only or analysis-only sub-agents. - Log actions to
progress.log(JSONL) in the repo root for resumability. - Keep the manifest; it is the single source of truth for cleanup.
Resources
scripts/create_worktrees.py: Create worktrees from a task list and writemanifest.json.scripts/status_worktrees.py: List worktrees (human text or JSON).scripts/cleanup_worktrees.py: Remove worktrees using the manifest; optionally delete branches and prune.
Examples
Create worktrees from a task list:
python -c "from pathlib import Path; Path('tasks.txt').write_text('api-auth\\nui-refresh:feature/ui-refresh\\ndocs\\n')"
python skills/parallelizing-with-worktrees/scripts/create_worktrees.py --tasks-file tasks.txt --run-id run-001
Inspect worktree status:
python skills/parallelizing-with-worktrees/scripts/status_worktrees.py
Cleanup:
python skills/parallelizing-with-worktrees/scripts/cleanup_worktrees.py --manifest ../<repo-name>-worktrees/run-001/manifest.json --delete-branches --prune
Validation
- Create a throwaway branch and two dummy tasks; verify worktrees are created and listed.
- Remove worktrees with
scripts/cleanup_worktrees.pyand confirmgit worktree listis clean.
Related Skills
aufrank/running-dag-pipelines
tools
VerifiedTrustedCommunity
Build and execute modular DAG workflows for long-context processing using slice/map/reduce/recurse/compact/filter operators. Use for one-shot batch jobs, standalone map-reduce pipelines, or when the context-dag plugin is not installed. Trigger when input exceeds the model's context window, when reproducible logged pipelines are needed, or when multi-level recursive processing is required. If context-dag is installed, the plugin's bundled dag_runner.py provides the same capability with persistent artifact storage.
SKILL.mdUpdated May 7, 2026
aufrank/austin-frank-voice
documentation
VerifiedTrustedCommunity
Write in Austin Frank's voice and style. Use this skill whenever generating text that should sound like Austin — strategy docs, charters, proposals, business cases, vision documents, staffing requests, stakeholder updates, cover letters, mission statements, org design documents, or any professional prose where the user wants Austin's distinctive voice. Also use when the user asks to review, edit, or improve a draft for voice consistency, or when they reference "my style", "my voice", "write like me", or "Austin's style".
SKILL.mdUpdated May 7, 2026
aufrank/working-with-notion-programmatically
tools
VerifiedTrustedCommunity
Use mcpc to interact with the Notion MCP server: connect sessions, search workspace content, fetch pages/databases, and run helper scripts for common Notion actions.
SKILL.mdUpdated Apr 3, 2026
aufrank/workflow-or-agent-decider
tools
VerifiedTrustedCommunity
Decide between a scripted workflow and an autonomous agent harness, then scaffold the chosen path. Use when scoping new agentic systems or tool integrations.
SKILL.mdUpdated Apr 3, 2026