worktree-safety

Community

Safely navigate Git worktrees and meta-workspaces.

Authoryangshu2087
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Safely operate in repositories that use Git worktrees or live inside a meta-workspace with multiple repos. This skill helps you avoid accidentally executing commands in the wrong repository by clearly identifying the active worktree and repository context, and by recognizing pointer directories and wrapper workspaces.

Core Features & Use Cases

  • Real repository detection: verify the top-level path and any worktree associations before executing commands.
  • Context validation: distinguish between normal repositories, pointer directories, and wrapper workspaces to avoid cross-repo side effects.
  • Safe operation guidance: provide checks and prompts to ensure the intended repository is targeted for branch or file operations.

Quick Start

Identify the real repository with git rev-parse --show-toplevel and validate any linked worktrees before executing git commands.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: worktree-safety
Download link: https://github.com/yangshu2087/Codex/archive/main.zip#worktree-safety

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.