How do I install the Richardgill Nix Worktrees skill?

Run npx skillmds@latest add tomevault-io/richardgill-nix-worktrees in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Richardgill Nix Worktrees skill do?

Worktrees It is listed under Coding & Dev Tools on SkillMD.

Is Richardgill Nix Worktrees safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Richardgill Nix Worktrees?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Richardgill Nix Worktrees free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Richardgill Nix Worktrees?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Richardgill Nix Worktrees by tomevault-io

Name: Richardgill Nix Worktrees
Author: tomevault-io

File contents

Worktrees

Create a git worktree in a new tmux session with Claude Code running a specific prompt.

Choosing the prompt file

Pick the best option based on what's available:

Issue file — if the work references an issue in thoughts/shared/issues/, use --prompt-file pointing to the issue's plan.md
Other .md file — if the user references a specific markdown file (design doc, spec, etc.), use --prompt-file with that path
Text prompt — otherwise, write the prompt text to a timestamped file in /tmp and pass that path via --prompt-file

Command

# With an issue or markdown file
~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$FILE" "$BRANCH"

# With a text prompt
PROMPT_FILE="/tmp/worktree-prompt-$(date +%Y%m%d-%H%M%S).md"
cat > "$PROMPT_FILE" <<'EOF'
$PROMPT
EOF
~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$PROMPT_FILE" "$BRANCH"

Parameters

$BRANCH - Branch name or remote/branch (e.g., my-feature)
$FILE - Path to a .md file to use as the prompt (e.g., thoughts/shared/issues/10-feature/plan.md)
$PROMPT - Text prompt to write to a timestamped /tmp file before passing via --prompt-file

Examples

# From an existing file 
~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file docs/migration-spec.md migration

# From a text prompt
PROMPT_FILE="/tmp/worktree-prompt-$(date +%Y%m%d-%H%M%S).md"
cat > "$PROMPT_FILE" <<'EOF'
fix the login bug
EOF
~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$PROMPT_FILE" fix-login

# From a remote branch
PROMPT_FILE="/tmp/worktree-prompt-$(date +%Y%m%d-%H%M%S).md"
cat > "$PROMPT_FILE" <<'EOF'
implement the feature from the PR description
EOF
~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$PROMPT_FILE" origin/feature-branch

Notes

Uses --no-switch to create the new tmux session without switching to it
Uses --pull to automatically pull main if behind (no prompt)
The new worktree session is created but not switched to
Claude Code starts automatically in the ai1 tmux window with the given prompt

$ARGUMENTS

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: richardgill-nix-worktreesdescription: Worktrees---# WorktreesCreate a git worktree in a new tmux session with Claude Code running a specific prompt.## Choosing the prompt filePick the best option based on what's available:1. **Issue file** — if the work references an issue in `thoughts/shared/issues/`, use `--prompt-file` pointing to the issue's `plan.md`2. **Other .md file** — if the user references a specific markdown file (design doc, spec, etc.), use `--prompt-file` with that path3. **Text prompt** — otherwise, write the prompt text to a timestamped file in `/tmp` and pass that path via `--prompt-file`## Command```bash# With an issue or markdown file~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$FILE" "$BRANCH"# With a text promptPROMPT_FILE="/tmp/worktree-prompt-$(date +%Y%m%d-%H%M%S).md"cat > "$PROMPT_FILE" <<'EOF'$PROMPTEOF~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$PROMPT_FILE" "$BRANCH"```## Parameters- `$BRANCH` - Branch name or remote/branch (e.g., `my-feature`)- `$FILE` - Path to a .md file to use as the prompt (e.g., `thoughts/shared/issues/10-feature/plan.md`)- `$PROMPT` - Text prompt to write to a timestamped `/tmp` file before passing via `--prompt-file`## Examples```bash# From an existing file ~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file docs/migration-spec.md migration# From a text promptPROMPT_FILE="/tmp/worktree-prompt-$(date +%Y%m%d-%H%M%S).md"cat > "$PROMPT_FILE" <<'EOF'fix the login bugEOF~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$PROMPT_FILE" fix-login# From a remote branchPROMPT_FILE="/tmp/worktree-prompt-$(date +%Y%m%d-%H%M%S).md"cat > "$PROMPT_FILE" <<'EOF'implement the feature from the PR descriptionEOF~/Scripts/worktree-branch --no-switch --pull --binary amp --prompt-file "$PROMPT_FILE" origin/feature-branch```## Notes- Uses `--no-switch` to create the new tmux session without switching to it- Uses `--pull` to automatically pull main if behind (no prompt)- The new worktree session is created but not switched to- Claude Code starts automatically in the `ai1` tmux window with the given prompt$ARGUMENTS---> Converted and distributed by [TomeVault](https://tomevault.io/claim/richardgill) — claim your Tome and manage your conversions.

Frequently asked questions

Richardgill Nix Worktrees