Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add qodex-ai/ai-agent-skills --skill workspace-isolation -a claude-code
Open on GitHub

What 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/auth branch 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-code

2Manually: put the files in place

~/.claude/skills/workspace-isolation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/workspace-isolation/

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.

Similar skills

All skills for Git and GitHub →

From the same set42

The whole set →
selection-randomizer selection-randomizer is a Claude Code skill that randomly picks winners and participants from lists. It can apply weights and exclude past winners. CX Codex +1 133installs branch-finalization branch-finalization verifies tests, presents four clear next steps, and handles merging, pull requests, or branch cleanup. CX Codex +1 131installs autonomous-cloud-orchestration autonomous-cloud-orchestration walks your agent through AWS Bedrock AgentCore: picking the right service and wiring the deployment with the AWS CLI. CX Codex +1 131installs capability-documentation The capability-documentation skill helps document other skills with clear structure, examples, and behavior checks. It fits reusable agent guidance that needs verification. CX Codex +1 130installs deployment-automation deployment-automation — a skill that automates Vercel deployments with build error fixes. The agent runs vercel --prod, reads logs via MCP tool, and patches code until deployment succeeds. CX Codex +1 129installs directive-synthesis directive-synthesis is a Claude Code skill for building slash commands, from arguments and frontmatter to Bash steps and testing. CX Codex +1 127installs media-transformation media-transformation rewrites uniform JSON arrays as TOON v2.0, with field names declared once and rows after. Useful when repeated records fill your context. CX Codex +1 126installs feedback-application The feedback-application skill turns review comments into tracked code changes, tests, and documentation updates. Use it when an agent needs to work through feedback item by item. CX Codex +1 126installs

Project sponsors

Companies that keep this analytics open