// Create, manage, and clean up git worktrees for isolated development, PR review, and A/B testing of agent configurations. Trigger keywords - worktree, worktrees, git worktree, parallel branches, isolated workspace, worktree cleanup, worktree prune, PR review, address PR comments, work on branch, work on PR.
uv package management, dependency groups, PyTorch index handling, hatch build system, and versioning for this repo. Triggers on: uv, uv sync, uv lock, uv add, uv build, dependency, pyproject.toml, extras, cpu, cu128, hatch, wheel, version, publish.
Use NeMo Safe Synthesizer through task-specific routing: running the CLI or SDK, configuring parameters, troubleshooting runtime failures, inspecting artifacts, and interpreting evaluation outputs. Use when the user asks about safe-synthesizer, NeMo Safe Synthesizer, synthetic data pipeline runs, DP settings, generation failures, artifacts, logs, offline/GPU setup, config overrides, or evaluation metrics.
Interact with the Safe-Synthesizer GitHub repository using the gh CLI. Activate when users want to list or create pull requests, check out PRs, work on someone else's PR, check CI status, investigate workflow failures, view job logs, create or triage issues, check review and approval status, manage releases, or inspect repo metadata. Trigger keywords - pull request, PR, issue, workflow, CI, actions, failed job, job log, release, review, approve, CODEOWNERS, labels, milestone, checkout, gh, GitHub.
| name | git-worktrees |
| description | Create, manage, and clean up git worktrees for isolated development, PR review, and A/B testing of agent configurations. Trigger keywords - worktree, worktrees, git worktree, parallel branches, isolated workspace, worktree cleanup, worktree prune, PR review, address PR comments, work on branch, work on PR. |
| license | Apache-2.0 |
Safe-Synthesizer-specific additions to the base git-worktrees skill. Read the base skill first (available globally via agent-stuff), then apply the overrides below.
Cursor parallel-agent worktrees created via the IDE run .cursor/setup-worktree.sh automatically at creation time. This script runs uv sync --frozen unconditionally, producing a local .venv in the worktree. No manual setup needed.
The sessionStart hook (.cursor/hooks/session_context.sh) also runs uv sync --frozen if .venv is absent at session start, covering Claude Code worktree sessions.
When creating a worktree manually (e.g., for PR review or feature work), always run uv sync --frozen after creation:
cd "$SS_WORKTREE_DIR/ss-wt-<name>"
uv sync --frozen
This creates a local .venv in the worktree. With uv's cache the install takes ~2-3 seconds on a warm cache.
If you need different extras (e.g. cu129 vs cpu), pass them explicitly:
uv sync --frozen --extra cu129 --extra engine --group dev
Never run bare uv sync without --frozen -- it re-locks uv.lock and creates dirty state.
Note: The base skill describes sharing the main repo's .venv via UV_PROJECT_ENVIRONMENT as the default. In this repo, the Cursor worktree automation always creates a local .venv, so UV_PROJECT_ENVIRONMENT is not needed for Cursor-managed worktrees. Use it only for quick throwaway sessions where you know the deps are identical.
Every commit requires both DCO sign-off and GPG signing. The enforce-signoff.sh hook blocks commits that omit either:
git commit --signoff --gpg-sign -m "message"
# or short flags:
git commit -s -S -m "message"
Never hand-write the Signed-off-by trailer -- it must come from --signoff so it matches git config user.name / user.email exactly.
GitHub marks commits as "Verified" when the signing key matches a key registered in your GitHub account (Settings → SSH and GPG keys). Commits squash-merged by GitHub are signed by GitHub's own key -- only locally-created commits need your personal key.