file-search

Category: Development & Coding | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

Use when searching codebases (text, structural/AST, files by name, PDFs/archives, code stats) or building context before a task.

Changelog: Source: GitHub https://github.com/netresearch/file-search-skill

Directory Structure

Current level: tree/main/skills/file-search/

📁 evals/
- 📄 evals.json 17.0 KB
📁 references/
- 📄 ast-grep-patterns.md 10.1 KB
- 📄 code-metrics.md 1.1 KB
- 📄 fd-guide.md 2.5 KB
- 📄 remote-handoff.md 1.7 KB
- 📄 rga-guide.md 1.7 KB
- 📄 ripgrep-patterns.md 9.3 KB
- 📄 search-strategies.md 1.1 KB
- 📄 tool-comparison.md 7.2 KB
📄 SKILL.md 3.3 KB

SKILL.md

---
name: file-search
description: "Use when searching codebases (text, structural/AST, files by name, PDFs/archives, code stats) or building context before a task."
license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"
compatibility: "Requires ripgrep (rg). Optional: fd, ast-grep, rga, tokei, scc."
metadata:
  author: Netresearch DTT GmbH
  version: "1.2.0"
  repository: https://github.com/netresearch/file-search-skill
allowed-tools: Bash(rg:*) Bash(fd:*) Bash(sg:*) Bash(rga:*) Bash(tokei:*) Bash(scc:*) Read Glob Grep
---

# File Search Skill

Efficient CLI search tools for AI agents.

## Tool Selection Guide

| Task | Use | Instead of |
|------|-----|------------|
| Search text in code files | `rg` (ripgrep) | `grep`, `grep -r` |
| Find files by name/path | `fd` | `find`, `ls -R` |
| Structural/syntax-aware code search | `sg` (ast-grep) | regex hacks |
| Search PDFs, Office docs, archives | `rga` (ripgrep-all) | manual extraction |
| Count lines of code by language | `tokei` | `cloc`, `wc -l` |
| Code stats with complexity metrics | `scc` | `cloc`, `tokei` |

**Decision flow:** text/regex → `rg` | code structure (empty catches,
function sigs, multi-line patterns) → `sg` | files by name → `fd` |
PDFs/archives → `rga` | codebase stats → `tokei`/`scc`

## Quick Examples

```bash
rg 'def \w+\(' -t py src/          # rg: text search in Python files
rg -c 'TODO' -t js | wc -l         # rg: count first, then drill down
sg --pattern 'console.log($$$)' --rewrite 'logger.info($$$)' --lang js  # sg: structural replace
fd -g '*.test.ts' --changed-within 1d  # fd: -g for compound suffixes (NOT -e)
fd -g '*_test.go' -X rg 'func Test'   # fd+rg: find files, verify contents
rga 'quarterly revenue' docs/       # rga: search inside PDFs/archives
tokei --sort code                   # tokei: language stats
scc --wide                          # scc: complexity + COCOMO
```

## Best Practices

1. **Start narrow.** Specify types (`-t`, `--lang`, `-e`), scope dirs, count first (`rg -c`).
2. **Exclude noise** (`-g '!vendor/'`, `fd -E node_modules`).
3. **`--json`** for programmatic processing.
4. **rg ≠ fd types.** `rg -t ts` includes `.tsx`; `fd -e ts` does NOT. No `-t tsx` in rg.

See [references/search-strategies.md](references/search-strategies.md).

## Beyond Local Files

If local search finds nothing and context lives in issues/PRs/external
docs — hand off (`gh`, Jira, WebFetch). Issue keys in comments signal this.

See [references/remote-handoff.md](references/remote-handoff.md).

## References

| Topic | File |
|-------|------|
| rg flags, patterns, recipes | [references/ripgrep-patterns.md](references/ripgrep-patterns.md) |
| ast-grep patterns by language | [references/ast-grep-patterns.md](references/ast-grep-patterns.md) |
| fd flags, usage, fd+rg combos | [references/fd-guide.md](references/fd-guide.md) |
| rga formats, usage, caching | [references/rga-guide.md](references/rga-guide.md) |
| tokei and scc usage | [references/code-metrics.md](references/code-metrics.md) |
| Search targeting strategies | [references/search-strategies.md](references/search-strategies.md) |
| Tool comparison and decision guide | [references/tool-comparison.md](references/tool-comparison.md) |
| Remote context handoff guide | [references/remote-handoff.md](references/remote-handoff.md) |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

file-search

Directory Structure

SKILL.md

Report

Notice