How do I install the Ring:creating Worktrees skill?

Run npx skillmds@latest add lerianstudio/ring-creating-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.

Is Ring:creating Worktrees safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ring:creating 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 Ring:creating Worktrees free to use?

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

Who published Ring:creating Worktrees?

LerianStudio (@lerianstudio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ring:creating Worktrees by lerianstudio

Name: Ring:creating Worktrees
Rating: 4.5 (4 reviews)
Author: LerianStudio

Ring:creating Worktrees

Creating an isolated git worktree for parallel branch work: selects the directory by priority order, verifies/adds .gitignore safety, auto-installs the detected toolchain's dependencies, runs a baseline test, and reports readiness. Use before a feature that needs isolation from the main workspace or before executing an implementation plan. Skip for a quick fix on the current branch or when already in the feature's worktree.

LerianStudio d6c56a2 3.1 KB Updated Sep 10, 2026

File contents

Using Git Worktrees

When to use

Starting feature that needs isolation from main workspace
Before executing implementation plan
Working on multiple features simultaneously

Skip when

Quick fix in current branch → stay in place
Already in isolated worktree for this feature → continue
Repository doesn't use worktrees → use standard branch workflow

Sequence

Runs before: ring:writing-plans

Git worktrees create isolated workspaces sharing the same repository for parallel branch work.

Announce at start: "Using ring:creating-worktrees skill to set up isolated workspace."

Directory Selection (priority order)

Existing .worktrees/ or worktrees/ directory
CLAUDE.md preference (grep -i "worktree.*director" CLAUDE.md)
Ask user: .worktrees/ (project-local, hidden) OR ~/.config/ring/worktrees/<project>/ (global)

ls -d .worktrees worktrees 2>/dev/null

Safety Verification

Project-local directories only: Verify .gitignore before creating:

grep -q "^\.worktrees/$\|^worktrees/$" .gitignore

Not in .gitignore → add it → commit → proceed. (Prevents accidentally tracking worktree contents.)

Global directory (~/.config/ring/worktrees): No verification needed.

Creation Steps

# 1. Detect project name
project=$(basename "$(git rev-parse --show-toplevel)")

# 2. Create worktree
git worktree add "$path" -b "$BRANCH_NAME" && cd "$path"

# 3. Auto-detect and run setup
[ -f package.json ] && npm install
[ -f Cargo.toml ] && cargo build
[ -f requirements.txt ] && pip install -r requirements.txt
[ -f pyproject.toml ] && poetry install
[ -f go.mod ] && go mod download

# 4. Verify clean baseline
npm test / cargo test / pytest / go test ./...

If tests fail: Report failures, ask whether to proceed.
If tests pass: Report: Worktree ready at <path> | Tests passing (<N> tests) | Ready to implement <feature>

Quick Reference

Situation	Action
`.worktrees/` exists	Use it (verify .gitignore)
Both `.worktrees/` and `worktrees/` exist	Use `.worktrees/`
Neither exists	Check CLAUDE.md → ask user
Directory not in .gitignore	Add immediately + commit
Tests fail during baseline	Report failures + ask

Non-Negotiables

Project-local directories MUST be in .gitignore before creation
Baseline test verification REQUIRED before proceeding with work
Directory selection MUST follow priority order
Dependency installation MUST run (auto-detect from project files)

Integration

Pairs with finishing-a-development-branch for cleanup and ring:running-dev-cycle for work.

---name: ring-creating-worktreesdescription: Creating an isolated git worktree for parallel branch work: selects the directory by priority order, verifies/adds .gitignore safety, auto-installs the detected toolchain's dependencies, runs a baseline test, and reports readiness. Use before a feature that needs isolation from the main workspace or before executing an implementation plan. Skip for a quick fix on the current branch or when already in the feature's worktree.---# Using Git Worktrees## When to use- Starting feature that needs isolation from main workspace- Before executing implementation plan- Working on multiple features simultaneously## Skip when- Quick fix in current branch → stay in place- Already in isolated worktree for this feature → continue- Repository doesn't use worktrees → use standard branch workflow## Sequence**Runs before:** ring:writing-plansGit worktrees create isolated workspaces sharing the same repository for parallel branch work.**Announce at start:** "Using ring:creating-worktrees skill to set up isolated workspace."## Directory Selection (priority order)1. Existing `.worktrees/` or `worktrees/` directory2. CLAUDE.md preference (`grep -i "worktree.*director" CLAUDE.md`)3. Ask user: `.worktrees/` (project-local, hidden) OR `~/.config/ring/worktrees/<project>/` (global)```bashls -d .worktrees worktrees 2>/dev/null```## Safety Verification**Project-local directories only:** Verify `.gitignore` before creating:```bashgrep -q "^\.worktrees/$\|^worktrees/$" .gitignore```Not in `.gitignore` → add it → commit → proceed. (Prevents accidentally tracking worktree contents.)**Global directory** (`~/.config/ring/worktrees`): No verification needed.## Creation Steps```bash# 1. Detect project nameproject=$(basename "$(git rev-parse --show-toplevel)")# 2. Create worktreegit worktree add "$path" -b "$BRANCH_NAME" && cd "$path"# 3. Auto-detect and run setup[ -f package.json ] && npm install[ -f Cargo.toml ] && cargo build[ -f requirements.txt ] && pip install -r requirements.txt[ -f pyproject.toml ] && poetry install[ -f go.mod ] && go mod download# 4. Verify clean baselinenpm test / cargo test / pytest / go test ./...```**If tests fail:** Report failures, ask whether to proceed. **If tests pass:** Report: `Worktree ready at <path> | Tests passing (<N> tests) | Ready to implement <feature>`## Quick Reference| Situation | Action ||-----------|--------|| `.worktrees/` exists | Use it (verify .gitignore) || Both `.worktrees/` and `worktrees/` exist | Use `.worktrees/` || Neither exists | Check CLAUDE.md → ask user || Directory not in .gitignore | Add immediately + commit || Tests fail during baseline | Report failures + ask |## Non-Negotiables- Project-local directories MUST be in .gitignore before creation- Baseline test verification REQUIRED before proceeding with work- Directory selection MUST follow priority order- Dependency installation MUST run (auto-detect from project files)## IntegrationPairs with **finishing-a-development-branch** for cleanup and **ring:running-dev-cycle** for work.

Frequently asked questions