How do I install the Rg skill?

Run npx skillmds add majiayu000/rg in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rg?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rg by majiayu000 — Agent Skill

Name: Rg
Rating: 4.2 (5 reviews)
Author: majiayu000

This skill should be used when the user asks to "search for pattern in codebase", "find all uses of function", "grep for string across files", "find TODO comments", "search in specific file types", "count occurrences", or when needing efficient text search with context, line numbers, or special flags.

majiayu000 f948859 2 files · 3.0 KB Updated Sep 9, 2026 567 repo stars

File contents

rg: Ripgrep Text Search

Efficient text search using ripgrep with one-shot patterns that minimize iterations.

Tool Selection

Grep tool (built-in) - Use for structured searches:

Basic pattern matching with structured output
File type filtering with type parameter
Handles 95% of search needs

Bash(rg) - Use when needing:

Fixed string search (-F)
Invert match (-v)
Word boundaries (-w)
Context lines (-C 2)
Pipe composition (| head, | wc -l)
One-shot results with line numbers

Quick Reference

# Basic search with line numbers and context
rg -n -C 2 'pattern' .

# Case insensitive
rg -i 'pattern' .

# Fixed string (no regex)
rg -F 'console.log(' .

# Word boundaries
rg -w 'function' .

# Specific file types
rg -t js 'import' .
rg -t py 'def ' .
rg -t ts 'interface' .

# Exclude directories
rg --glob '!node_modules' 'pattern' .

# Count matches
rg -c 'TODO' .

# Files only (no content)
rg -l 'pattern' .

Common Patterns

# Find function definitions
rg 'function \w+\(' -t js .
rg 'def \w+\(' -t py .
rg 'func \w+\(' -t go .

# Find imports/requires
rg "import .* from" -t js .
rg "require\(" -t js .

# Find TODOs/FIXMEs
rg 'TODO|FIXME' .

# Find console.log (for cleanup)
rg -F 'console.log' -t js .

# Find class definitions
rg 'class \w+' -t ts .

# Find API endpoints
rg "app\.(get|post|put|delete)\(" -t js .

File Type Flags

-t js      # JavaScript
-t ts      # TypeScript
-t py      # Python
-t go      # Go
-t rust    # Rust
-t ruby    # Ruby
-t java    # Java
-t cpp     # C++
-t md      # Markdown
-t json    # JSON
-t yaml    # YAML

Context and Output

# Lines before/after match
rg -B 3 'pattern' .     # 3 lines before
rg -A 3 'pattern' .     # 3 lines after
rg -C 3 'pattern' .     # 3 lines both

# Show line numbers
rg -n 'pattern' .

# Show column numbers
rg --column 'pattern' .

# JSON output
rg --json 'pattern' .

Pipe Composition

# First 10 matches
rg 'pattern' . | head -10

# Count total matches
rg 'pattern' . | wc -l

# Sort by file
rg 'pattern' . | sort

# Unique files only
rg -l 'pattern' . | sort -u

Core Principle

Get files, line numbers, and context in a single call. Minimize search iterations.

---name: rgdescription: This skill should be used when the user asks to "search for pattern in codebase", "find all uses of function", "grep for string across files", "find TODO comments", "search in specific file types", "count occurrences", or when needing efficient text search with context, line numbers, or special flags.--- # rg: Ripgrep Text Search Efficient text search using ripgrep with one-shot patterns that minimize iterations. ## Tool Selection **Grep tool (built-in)** - Use for structured searches: - Basic pattern matching with structured output - File type filtering with `type` parameter - Handles 95% of search needs **Bash(rg)** - Use when needing: - Fixed string search (`-F`) - Invert match (`-v`) - Word boundaries (`-w`) - Context lines (`-C 2`) - Pipe composition (`| head`, `| wc -l`) - One-shot results with line numbers ## Quick Reference ```bash # Basic search with line numbers and context rg -n -C 2 'pattern' . # Case insensitive rg -i 'pattern' . # Fixed string (no regex) rg -F 'console.log(' . # Word boundaries rg -w 'function' . # Specific file types rg -t js 'import' . rg -t py 'def ' . rg -t ts 'interface' . # Exclude directories rg --glob '!node_modules' 'pattern' . # Count matches rg -c 'TODO' . # Files only (no content) rg -l 'pattern' . ``` ## Common Patterns ```bash # Find function definitions rg 'function \w+\(' -t js . rg 'def \w+\(' -t py . rg 'func \w+\(' -t go . # Find imports/requires rg "import .* from" -t js . rg "require\(" -t js . # Find TODOs/FIXMEs rg 'TODO|FIXME' . # Find console.log (for cleanup) rg -F 'console.log' -t js . # Find class definitions rg 'class \w+' -t ts . # Find API endpoints rg "app\.(get|post|put|delete)\(" -t js . ``` ## File Type Flags ```bash -t js # JavaScript -t ts # TypeScript -t py # Python -t go # Go -t rust # Rust -t ruby # Ruby -t java # Java -t cpp # C++ -t md # Markdown -t json # JSON -t yaml # YAML ``` ## Context and Output ```bash # Lines before/after match rg -B 3 'pattern' . # 3 lines before rg -A 3 'pattern' . # 3 lines after rg -C 3 'pattern' . # 3 lines both # Show line numbers rg -n 'pattern' . # Show column numbers rg --column 'pattern' . # JSON output rg --json 'pattern' . ``` ## Pipe Composition ```bash # First 10 matches rg 'pattern' . | head -10 # Count total matches rg 'pattern' . | wc -l # Sort by file rg 'pattern' . | sort # Unique files only rg -l 'pattern' . | sort -u ``` ## Core Principle Get files, line numbers, and context in a single call. Minimize search iterations.

Frequently asked questions