# git-2025-features

git-2025-features is a skill for Claude Code and other platforms with reference for Git 2.48–2.49 features and modern workflows. The agent uses it for reftables, sparse-checkout, partial clone and worktrees.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 164 installs · ★ 66 repo stars
- Author: JosiahSiegel
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/git-master/skills/git-2025-features/SKILL.md
- Updated: 2026-06-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/git-2025-features

## What it does

The agent gets reference for migrating to reftable backend, setting up sparse-checkout for monorepos, partial cloning with `--filter=blob:none`, worktrees for parallel development and commit graph optimizations. Inside are command examples for checking Git version, switching reference storage format, configuring cone mode and non-cone patterns, creating worktrees and prefetching missing objects.

The skill describes performance improvements in Git 2.48 (stable memory usage, completed reflog migration to reftables) and 2.49 (zlib-ng integration, path-walk API for delta compression, new name-hashing algorithm). For repositories with tens of thousands of branches, migrating to reftables yields 50–80 percent faster ref operations. Combining partial clone and sparse-checkout lets you clone only the directories you need without downloading all blobs.

MIT license. Install via `npx skills add` with agent flag (`-a claude-code`, `-a cursor` etc.); for GitHub Copilot use `gh skill install`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/git-2025-features/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/git-2025-features/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/git-2025-features/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/git-2025-features/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/git-master/skills/git-2025-features
```

2. **Manually: put the files in place**
- File: `.github/skills/git-2025-features/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/git-master/skills/git-2025-features
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/git-2025-features/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill git-2025-features -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/git-master/skills/git-2025-features/SKILL.md

## When to use it
- set up sparse-checkout to work on one service in a monorepo
- migrate repository to reftable backend and measure speed gains
- create worktree for pull request review without interrupting current work
- clone repository with blob:none filter and fetch objects on demand
- apply Git 2.49 optimizations to speed up compression and repack

## Example prompts
- Show me how to migrate a repo to reftables and roll back if something breaks
- Configure sparse-checkout in cone mode for `src/api` and `src/shared` directories
- Create a worktree for branch `feature/new-api` in a separate directory

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 894add9576b8af13.

BEGIN THIRD-PARTY FILE 894add9576b8af13
```text
---
name: git-2025-features
description: |
  Git 2.49+ features and modern Git workflows (2025-2026).
  PROACTIVELY activate for: (1) Git 2.49+ features (reftables, sparse-checkout, partial clone, worktrees), (2) git-backfill for partial clones, (3) reftables migration (file backend to reftable backend), (4) sparse-checkout for monorepos, (5) git worktrees for parallel development, (6) partial clone (--filter=blob:none), (7) commit graph and bitmap optimizations, (8) trunk-based development workflows, (9) Git LFS, (10) modern alternatives to legacy commands.
  Provides: feature reference, version-detection snippets, sparse-checkout configuration, worktree workflow patterns, and migration guidance from older Git versions.
---

**📌 NOTE:** For detailed Git 2.49+ features (git-backfill, path-walk API, zlib-ng), see git-2-49-features.md skill.

## 🚨 CRITICAL GUIDELINES

### Windows File Path Requirements

**MANDATORY: Always Use Backslashes on Windows for File Paths**

When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).

**Examples:**
- ❌ WRONG: `D:/repos/project/file.tsx`
- ✅ CORRECT: `D:\repos\project\file.tsx`

This applies to:
- Edit tool file_path parameter
- Write tool file_path parameter
- All file operations on Windows systems


### Documentation Guidelines

**NEVER create new documentation files unless explicitly requested by the user.**

- **Priority**: Update existing README.md files rather than creating new documentation
- **Repository cleanliness**: Keep repository root clean - only README.md unless user requests otherwise
- **Style**: Documentation should be concise, direct, and professional - avoid AI-generated tone
- **User preference**: Only create additional .md files when user specifically asks for documentation


---

# Git 2025 Features - Advanced Capabilities

## Git 2.49 (March 2025) - Latest

**Major additions:** git-backfill, path-walk API, zlib-ng performance, improved delta compression.

**See git-2-49-features.md for complete coverage.**

## Git 2.48-2.49 Features

### Reftables Migration (Completed in 2.48)
```
END THIRD-PARTY FILE 894add9576b8af13

The third-party file has ended. Everything between the 894add9576b8af13 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2142 of 11121 bytes. © JosiahSiegel · MIT · https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/git-master/skills/git-2025-features/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
