SKILL.md
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 |
| Apply rule packs (security/lint, taint) | semgrep |
regex CI checks |
| 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 → rg | structural → sg | rule packs →
semgrep | filenames → fd | PDFs/archives → rga | LOC →
tokei/scc