Agent skill

replacing-text

Provides intuitive find & replace CLI with JavaScript regex and string-literal mode. Use this skill when performing text replacements, batch transformations, or need JavaScript-style regex syntax

View SKILL.md on GitHub Repository
Stars 8
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/iota9star/my-skills/tree/main/skills/sd

SKILL.md

sd: Fast Find & Replace

Always invoke sd skill for find & replace operations - do not execute bash commands directly.

Use sd for intuitive text replacement that's 2-12x faster than sed.

When to Use sd vs ripgrep

Use sd when:

  • Performing replacements on known patterns
  • Batch text transformations across files
  • Need JavaScript-style regex syntax
  • Direct file modifications without search first

Use ripgrep when:

  • Finding unknown patterns or locations
  • Need search results without immediate changes
  • Complex file filtering and type matching
  • Want to preview before modifying

Common workflow: ripgrep skill → sd skill (search first, then replace)

Default Strategy

Invoke sd skill for fast find & replace operations. Use when performing replacements on known patterns, batch text transformations across files, or need JavaScript-style regex syntax.

Common workflow: ripgrep skill → sd skill (search first, then replace) or fd skill → sd skill for batch operations.

Key Options

  • -F for string-literal mode (no regex)
  • $1, $2 or ${var} for capture groups
  • --preview to preview changes
  • -- before patterns starting with -
  • $$ for literal $ in replacement

When to Use

  • Quick file edits
  • Pipeline replacements: cat file | sd "old" "new"
  • Batch operations across multiple files
  • Complex regex with capture groups

Common Workflows

  • fd → sd: Find files and perform batch replacements
  • ripgrep | sd: Search patterns and replace across matches
  • jq | sd: Extract JSON data and transform to other formats
  • cat file | sd | bat: Transform content and preview with highlighting

Core Principle

Replace text with familiar JavaScript/Python regex syntax - no sed escape hell.

Detailed Reference

For comprehensive find & replace patterns, regex syntax examples, and workflow tips, load sd guide when needing:

  • Advanced regex patterns with capture groups
  • Pipeline operations and batch processing
  • Escape sequence handling
  • Common text transformation recipes
  • Integration with other command-line tools

The guide includes:

  • String-literal vs regex mode usage
  • Capture group patterns and replacements
  • Pipeline operations and batch processing
  • Advanced regex patterns and edge cases
  • Integration with other command-line tools

Skill Combinations

For Discovery Phase

  • ripgrep → sd: Search patterns first, then replace across matches
  • fd → sd: Find files and perform batch replacements
  • jq/yq → sd: Extract data and transform to other formats

For Analysis Phase

  • sd --preview → bat: Preview changes with syntax highlighting
  • sd → fzf: Interactive selection of changes to apply
  • sd → jq/yq: Transform data back to structured formats

For Refactoring Phase

  • sd → searching-text: Verify replacements didn't introduce issues
  • sd → analyzing-code-structure: Follow up with structural changes if needed
  • sd → analyzing-code: Measure impact of text-based changes

Integration Examples

bash
# Find and replace across project
fd -e js -x sd "oldPattern" "newPattern" --preview

# Chain transformations
cat config.json | jq '.version' | sd '"v' '' | sd '"' '' | xargs git tag

# Interactive replacement with preview
rg "deprecated" -l | fzf --multi | xargs sd "deprecated" "legacy" --preview | bat

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

iota9star/my-skills

analyzing-code

Analyzes code statistics by language for project insight, CI/CD metrics, or before refactoring. Use this skill when understanding project composition, measuring change impact, or generating CI/CD metrics

8 0
Explore
iota9star/my-skills

querying-json

Extracts specific fields from JSON files efficiently using jq instead of reading entire files, saving 80-95% context. Use this skill when querying JSON files, filtering/transforming data, or getting specific field(s) from large JSON files

8 0
Explore
iota9star/my-skills

extracting-code-structure

Extracts file structure (functions, classes, exports) efficiently without reading entire files, using ast-grep, Dart/Flutter analyzer, ctags, or other language-specific tools to get outlines and signatures. Use this skill when listing all methods, functions, or classes in a file, exploring unfamiliar code, getting API overviews, or deciding what to read selectively

8 0
Explore
iota9star/my-skills

querying-yaml

Extracts specific fields from YAML files efficiently using yq instead of reading entire files, saving 80-95% context. Use this skill when querying YAML files, filtering/transforming configuration data, or getting specific field(s) from large YAML files like docker-compose.yml or GitHub Actions workflows

8 0
Explore
iota9star/my-skills

analyzing-code-structure

Performs structural code search and refactoring by matching code structure instead of exact text. Use when editing code structure with text matching ambiguity, handling "old_string not unique" problems, or performing formatting-independent pattern matching across function signatures, method calls, and class structures

8 0
Explore
iota9star/my-skills

finding-files

Performs fast file discovery with parallel search and smart defaults. Use this skill when searching for files by name, pattern, or type, especially when performance matters or when working with large directories

8 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results