skills.rest
John2143
John2143COMMUNITY
Explore all skills by this author →
WebsiteGitHub

agent-workspace

Create and manage git worktree workspaces for isolated agent tasks.

2|Updated Feb 17, 2017
Search Tags:#git#version control#worktree#task isolation#agent workspace
One-click install
npx skills add https://github.com/John2143/dotfiles --skill agent-workspace-john2143
Or copy as Structured Prompt for Agentâ–¼
Please help me install this Agent Skill.
Skill: agent-workspace
Source: https://github.com/John2143/dotfiles/tree/main/.claude/skills/agent-workspace
Command: npx skills add https://github.com/John2143/dotfiles --skill agent-workspace-john2143

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, bash, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill isolates agent tasks in git worktrees, allowing for clean, versioned execution and easy management of tasks and their outputs.

Core Features & Use Cases

  • Isolated Workspaces: Create a new git worktree for each task, ensuring no interference with the main codebase.
  • Task Execution: Execute tasks in the isolated worktree, with full git isolation for commits and changes.
  • Management: List, resume, and cleanup worktrees for efficient task management.
  • Use Case: When you need to perform a task that involves changes to the codebase, but you want to keep those changes isolated and versioned until they are ready for review.

Quick Start

Create a new workspace for a task with the command: /skill:agent-workspace "Refactor the auth module to use JWT tokens"

Frequently Asked Questions about agent-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I isolate code changes using git worktrees for automated tasks?â–¼

You can isolate code changes by creating a git worktree for each task, ensuring automated agents execute in a clean, versioned environment without interfering with the main codebase. This allows for independent checkpointing and commits.

Why should I use git worktrees for agent task execution instead of branches?â–¼

Git worktrees provide separate physical directories for each task, allowing agents to work in isolation without switching branches in a single directory. This prevents file conflicts and keeps uncommitted changes safely separated until ready for review.

Can I manage and resume isolated git workspaces after stopping a task?â–¼

Yes, you can list existing worktrees, resume paused tasks, and clean up completed workspaces. This management capability ensures efficient tracking and lifecycle control over isolated agent execution environments.

Do I need bash and git installed to create isolated agent workspaces?â–¼

Yes, you need git installed to handle worktree operations and bash to execute the required git commands. These dependencies are necessary for creating, checkpointing, and cleaning up the isolated task workspaces.

What is the best way to keep agent code modifications isolated until review?â–¼

The best way is to execute agent tasks within dedicated git worktrees. This isolates modifications and outputs in a separate working directory, keeping changes versioned and separated from your main branch until they are ready for review.

Related Skills

Explore More Software Engineering Skills→
alienstroalienstro

speckit-git-initialize

Initialize a Git repository with an initial commit for Specify projects.

Community
Basic
cryborg1211cryborg1211

vc:merge-worktree

Merge a git worktree branch into the main checkout and prune it.

Community
Intermediate
wannysimwannysim

ci-preflight

Run Turborepo CI checks for type checking, linting, formatting, and testing.

Community
Intermediate
luicabref97luicabref97

git:merge-worktree

Merge selected files, hunks, or commits from git worktrees into the current branch.

Community
Advanced