Skip to content
Engineering

Using Git Worktrees

obra/superpowers

Choose an isolated worktree only when repository work benefits from separation; preserve local changes.

SKILL.md

---
name: knoveya-using-git-worktrees
description: "Choose an isolated worktree only when repository work benefits from separation; preserve local changes. Use for matching engineering work."
---

# Using Git Worktrees

## Scope

Apply this guidance when the requested task matches the description. Honor the user's chosen outcome, repository rules, and existing authorization.

## Workflow

Choose an isolated worktree only when repository work benefits from separation; preserve local changes.

Before acting, inspect the relevant artifact and ask only for information that materially changes the result. Use existing tools and conventions; do not install dependencies, publish, send messages, deploy, or mutate external data unless the user has authorized that operation.

## Acceptance check

No reset or checkout discards unrelated work.

## Example task

Inspect existing attachments before creating another checkout.

## Report

State what changed, the evidence checked, and what remains unverified. Do not claim a successful operation or completed test without observing it.

How to use

Copy the full block, including its frontmatter, into a new folder named knoveya-using-git-worktrees as SKILL.md. Review the instructions before enabling them. For Codex, a user skill normally lives in ~/.codex/skills/knoveya-using-git-worktrees/SKILL.md; check the current documentation for another agent's supported location. Do not overwrite an existing skill.

This is an independent Knoveya skill. No files are installed by this website.

Example

Inspect existing attachments before creating another checkout.

Verify

No reset or checkout discards unrelated work.

Test the skill on a small, authorized example. File validation alone does not prove that an agent will make good decisions.

Limits

The skill supplies instructions, not tool access or expertise guarantees. Inspect generated work and preserve the user's approval boundaries.