# Ripgrep

> Ripgrep is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Efficient text search using ripgrep (rg) with one-shot patterns that minimize iterations by getting files, line numbers, and context in a single call

- Skill name: `ripgrep`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/ripgrep/SKILL.md
- Repository: majiayu000/claude-skill-registry (498 GitHub stars when collected)

## SKILL.md

# ripgrep: Powerful, one-shot text search

## Default Strategy

**For content search: use Bash(rg) with `-e 'pattern' -n -C 2` for one-shot results.**

This gives files, line numbers, and context in a single call - minimizes iterations and context usage.

Always prefer getting line numbers and surrounding context over multiple search attempts.

## Tool Selection

**Grep tool** (built on ripgrep) - Use for structured searches:
- Basic pattern matching with structured output
- File type filtering with `type` parameter
- When special flags like `-F`, `-v`, `-w`, or pipe composition are not needed
- Handles 95% of search needs

**Bash(rg)** - Use for one-shot searches needing special flags or composition:
- Fixed string search (`-F`)
- Invert match (`-v`)
- Word boundaries (`-w`)
- Context lines with patterns (`-n -C 2`)
- Pipe composition (`| head`, `| wc -l`, `| sort`)
- Default choice for efficient one-shot results

**Glob tool** - Use for file name/path matching only (not content search)

## When to Load Detailed Reference

Load [ripgrep guide](./reference/ripgrep-guide.md) when needing:
- One-shot search pattern templates
- Effective flag combinations for complex searches
- Pipe composition patterns
- File type filters reference (`-t` flags)
- Pattern syntax examples
- Translation between Grep tool and rg commands
- Performance optimization for large result sets

The guide focuses on practical patterns for getting targeted results in minimal calls.

---

Source: https://www.openparable.com/skill/documents/ripgrep (OpenParable). Cite the canonical URL above.