windows-path-rename

Sanitize Git paths that are invalid on Windows (for example :, ", |, ?, * and trailing dot/space) and commit safe renames. Use when clone or checkout on Windows fails with "error: invalid path".

Jump to install

Repository: 981377660LMT/algorithm-study
Last source activity: March 30, 2026 at 16:22
Detected SKILL.md language: English
Stars: 277
Forks: 36

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/981377660LMT/algorithm-study --skill windows-path-rename

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

browser-tools

Interactive browser automation via Chrome DevTools Protocol. Use when you need to interact with web pages, test frontends, or when user interaction with a visible browser is required.

2026-03-31

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

2026-03-30

View all from this repository

Windows Path Rename

Use this skill when a repository contains file or directory names that cannot be created on Windows and Git reports error: invalid path.

When To Use

Clone or checkout fails on Windows due to invalid paths.

Team needs a permanent rename commit so Windows users can work normally.

You need a deterministic old->new mapping, with collision handling.

Workflow

Ensure a clean branch for rename work.

Run the bundled script in preview mode to generate a mapping.

Review mapping and conflict suffixes.

Apply renames (prefer Linux/WSL working tree mode).

Commit with a clear message and push.

Recommended Execution Modes

Preferred: run in WSL/Linux where old invalid names are materialized; script uses git mv.

Fallback (Windows-only, no invalid files materialized): generate mapping and apply via index plumbing in a controlled branch.

Commands

Preview only:

python .github/skills/windows-path-rename/scripts/sanitize_windows_paths.py --mode preview

Apply with git mv:

python .github/skills/windows-path-rename/scripts/sanitize_windows_paths.py --mode apply

Write mapping to a file:

python .github/skills/windows-path-rename/scripts/sanitize_windows_paths.py --mode preview --output .tmp/windows-path-map.tsv

Rename Rules

: -> -

" -> `` (remove)

| -> _

? -> `` (remove)

* -> _

< -> (

> -> )

Remove trailing dots/spaces from each path segment

Avoid Windows reserved names (CON, PRN, AUX, NUL, COM1..COM9, LPT1..LPT9) by appending _

Preserve file extension when possible

Resolve collisions by appending (n) before extension

Guardrails

Do not rename .git internals.

Do not run apply mode on a dirty working tree.

Commit only path renames in the rename commit.

After commit, verify no invalid paths remain with a preview run.

name	windows-path-rename
description	Sanitize Git paths that are invalid on Windows (for example :, ", \|, ?, * and trailing dot/space) and commit safe renames. Use when clone or checkout on Windows fails with "error: invalid path".