find-replace
Modern find-and-replace using sd (simpler than sed) and batch replacement patterns. Triggers on: sd, find replace, batch replace, sed replacement, string replacement, rename.
When & Why to Use This Skill
This Claude skill provides a modern and intuitive find-and-replace interface powered by the 'sd' CLI tool. It simplifies complex text manipulation tasks, offering a more user-friendly alternative to 'sed' for batch replacements, regex-based string updates, and large-scale code refactoring with built-in safety workflows.
Use Cases
- Bulk Code Refactoring: Quickly rename functions, variables, or classes across an entire project directory using simple syntax or word boundaries to avoid partial matches.
- Dependency Migration: Update import statements and library paths across hundreds of files simultaneously when restructuring projects or upgrading dependencies.
- Data Reformatting: Utilize regex capture groups to transform log formats, reorder CSV columns, or clean up configuration files with precision.
- Safe Batch Editing: Execute a controlled workflow by listing affected files and previewing replacements before applying changes to ensure data integrity.
| name | find-replace |
|---|---|
| description | "Modern find-and-replace using sd (simpler than sed) and batch replacement patterns. Triggers on: sd, find replace, batch replace, sed replacement, string replacement, rename." |
| compatibility | "Requires sd CLI tool. Install: brew install sd (macOS) or cargo install sd (cross-platform)." |
| allowed-tools | "Bash" |
Find Replace
Modern find-and-replace using sd.
sd Basics
# Replace in file (in-place)
sd 'oldText' 'newText' file.txt
# Replace in multiple files
sd 'oldText' 'newText' *.js
# Preview without changing (pipe)
cat file.txt | sd 'old' 'new'
sd vs sed
| sed | sd |
|---|---|
sed 's/old/new/g' |
sd 'old' 'new' |
sed -i 's/old/new/g' |
sd 'old' 'new' file |
sed 's#path/to#new/path#g' |
sd 'path/to' 'new/path' |
Key difference: sd is global by default, no delimiter issues.
Common Patterns
# Variable/function rename
sd 'oldName' 'newName' src/**/*.ts
# Word boundaries (avoid partial matches)
sd '\boldName\b' 'newName' src/**/*.ts
# Import path update
sd "from '../utils'" "from '@/utils'" src/**/*.ts
# Capture groups
sd 'console\.log\((.*)\)' 'logger.info($1)' src/**/*.js
Safe Batch Workflow
# 1. List affected files
rg -l 'oldPattern' src/
# 2. Preview replacements
rg 'oldPattern' -r 'newPattern' src/
# 3. Apply
sd 'oldPattern' 'newPattern' $(rg -l 'oldPattern' src/)
# 4. Verify
rg 'oldPattern' src/ # Should return nothing
git diff # Review changes
Special Characters
| Character | Escape |
|---|---|
. |
\. |
* |
\* |
[ ] |
\[ \] |
$ |
\$ |
\ |
\\ |
Tips
| Tip | Reason |
|---|---|
Always preview with rg -r first |
Avoid mistakes |
| Use git before bulk changes | Easy rollback |
Use \b for word boundaries |
Avoid partial matches |
| Quote patterns | Prevent shell interpretation |
Additional Resources
For detailed patterns, load:
./references/advanced-patterns.md- Regex, batch workflows, real-world examples