repo-text-sweeps

Guides grep and sed sweeps for renames and path relocations across repositories.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/missingbulb/GoogleCalendarEventCreator --skill repo-text-sweeps-missingbulb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-text-sweeps
Source: https://github.com/missingbulb/GoogleCalendarEventCreator/tree/main/.claudinite/shared/packs/basics/skills/repo-text-sweeps
Command: npx skills add https://github.com/missingbulb/GoogleCalendarEventCreator --skill repo-text-sweeps-missingbulb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Bulk find-replace operations, file renames, and path relocations silently corrupt repositories: references built from path.join segments survive rewrites, URLs get accidentally rewritten, half-converted paths break at runtime, and zero-hit greps produce false conclusions about absent tokens. ## Core Features & Use Cases - Rename sweep mechanics: Rules for scoping string replacements so target-namespace files are not double-prefixed and external URLs containing the old path string are not rewritten. - Post-rename verification: Techniques for catching references that survive a mechanical pass, including searching individual path segment tokens, matching slashed and bare path forms, and running the test suite as the real detector. - Search correctness: Guidance on case-insensitive greps, git pathspec exclusion instead of grep -v filtering, git ls-files for structural checks, and anchored text edits for hand-maintained JSON configs. - Use Case: When renaming foo/ to bar/foo/ across a repo, apply these rules to avoid double-prefixing, catch path.join-constructed references, and verify with tests before committing. ## Quick Start Before doing a bulk rename of the utils directory across this repo, apply the repo-text-sweeps rules and verify no references were missed afterward.

Frequently Asked Questions about repo-text-sweeps

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

FAQPage Schema
How do I rename a directory across a repo without breaking references?▼

Scope the string replacement to internal path references only, excluding URLs and files already under the target namespace. After the pass, grep for individual path segment tokens and run the test suite, since references built with path.join survive mechanical rewrites.

Why does my sed rename miss some file path references?▼

Paths constructed from segments like path.join(__dirname, "foo", "bar") or wrapped across comment lines do not match a literal path pattern. Search for the individual segment tokens after the rewrite and rely on tests to surface runtime breakage.

How do I exclude a directory from a grep reference search?▼

Use git pathspec exclusion such as git grep -n foo -- . ':(exclude)foo' rather than piping through grep -v. Filtering on line content also drops legitimate full-path references elsewhere, silently undercounting matches.

Why does my grep show zero results for a token that exists in the code?▼

Case-sensitive search misses tokens normalized to other cases, such as SCREAMING_SNAKE constants or uppercase data tables. Re-run with grep -i, and use git log -S<token> as a cross-check when history should have touched it.

Should I edit JSON config files with a script or text replacement?▼

Patch hand-maintained JSON as anchored text, never with a json.load and json.dumps round-trip. Round-tripping re-serializes the whole file, reordering keys and changing indentation, turning a one-field change into an unreviewable rewrite.