workspace-isolation — Claude Code skill: setup and use
workspace-isolation creates separate Git worktrees for parallel branch work. Use it when changes need their own working directories and a verified starting state.
LicenseRef-Proprietary 130 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a claude-codeWhat workspace-isolation does
The skill chooses a worktree location in a fixed order: an existing .worktrees/, then worktrees/, a preference in CLAUDE.md, or a prompt asking where to create it. For a project-local directory, it checks .gitignore first and adds and commits the matching rule when needed.
It creates a new branch with git worktree add, enters the directory, and selects setup steps from project files. Node.js, Rust, Python, and Go projects get the corresponding dependency command when their marker file is present. The skill then runs a project-appropriate test command and reports failures before continuing.
The skill targets Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. A local worktree cannot be created safely until .worktrees/ or worktrees/ is covered by .gitignore.
What it helps with
- create a separate working directory for a branch
- develop on several branches at once
- follow project rules when choosing a worktree path
- install dependencies in a fresh worktree
- verify tests before starting implementation
Example prompts for the agent
- Create an isolated worktree for the
feature/authbranch and prepare the project. - Check the worktree location and
.gitignore, then create a new branch workspace. - Set up a worktree for this task and run the project's baseline tests.
How to install workspace-isolation
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a claude-code2Manually: put the files in place
~/.claude/skills/workspace-isolation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/workspace-isolation/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a codex2Manually: put the files in place
.agents/skills/workspace-isolation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a cursor2Manually: put the files in place
.cursor/skills/workspace-isolation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/workspace-isolation2Manually: put the files in place
.github/skills/workspace-isolation/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/workspace-isolationManually: put the files in place
.devin/skills/workspace-isolation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about workspace-isolation
How do I install workspace-isolation in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a claude-code. Then check ~/.claude/skills/workspace-isolation/SKILL.md.
What does workspace-isolation do?
It creates separate Git worktrees for branch-based work, prepares dependencies from project files, and runs baseline tests before implementation continues.
How does the skill choose a worktree directory?
It checks .worktrees/ first, then worktrees/. If neither exists, it reads CLAUDE.md and otherwise asks whether to use a local or global location.