Login
netresearch/file-search-skillSee repository11 files

File Search

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

Use this skillView repositoryView on skills.sh
Specification
Skill ID
netresearch/file-search-skill/file-search
Publisher
netresearch
Repository
file-search-skill
Installs
0
Files
11
License
See repository
Requires
Requires ripgrep (rg). Optional: fd, ast-grep, rga, tokei, scc, semgrep.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

netresearch/file-search-skill/file-searchInstalls these files
  • SKILL.md
  • evals/evals.json
  • references/ast-grep-patterns.md
  • references/code-metrics.md
  • references/enforcement-hook.md
  • references/fd-guide.md
  • references/remote-handoff.md
  • references/rga-guide.md
  • references/ripgrep-patterns.md
  • references/search-strategies.md
  • references/semgrep-patterns.md

What this skill tells the agent

File Search Skill

Efficient CLI search tools for AI agents.

Tool Selection Guide

TaskUseInstead of
Search text in code filesrg (ripgrep)grep, grep -r
Find files by name/pathfdfind, ls -R
Structural/syntax-aware code searchsg (ast-grep)regex hacks
Apply rule packs (security/lint, taint)semgrepregex CI checks
Search PDFs, Office docs, archivesrga (ripgrep-all)manual extraction
Count lines of code by languagetokeicloc, wc -l
Code stats with complexity metricsscccloc, tokei

Decision flow: text → rg | structural → sg | rule packs → semgrep | filenames → fd | PDFs/archives → rga | LOC → tokei/scc

Quick Examples

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. Batch independent queries. Union patterns with rg -e P1 -e P2 -e P3 (one walk), or issue distinct queries as parallel tool calls in one message — never sequential && chains.
  4. `--json` for programmatic processing.
  5. rg ≠ fd types. rg -t ts includes .tsx; fd -e ts does NOT. No -t tsx in rg.

See 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

TopicFile
rg flags, patterns, recipesreferences/ripgrep-patterns.md
ast-grep patterns by languagereferences/ast-grep-patterns.md
semgrep rules and taint modereferences/semgrep-patterns.md
fd flags, usage, fd+rg combosreferences/fd-guide.md
rga formats, usage, cachingreferences/rga-guide.md
tokei and scc usagereferences/code-metrics.md
PreToolUse nudge (ships with plugin)references/enforcement-hook.md
Search targeting strategiesreferences/search-strategies.md
Remote context handoff guidereferences/remote-handoff.md
Modern CLI tools comparison (legacy→modern, all domains)cli-tools-skill/SKILL.md#preferred-modern-tools

More from netresearch

netresearch/agent-rules-skill

Agent Rules

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents.

netresearch/context7-skill

Context7

Use when looking up library documentation, API references, framework patterns, or code examples for ANY library (React, Next.js, Vue, Django, Laravel, etc.) and the Context7 MCP server is unavailable or not configured. Fetches the same current docs directly via the Context7 REST API as a fallback. Triggers on: how to use library, API docs, framework pattern, import usage, library example.

netresearch/git-workflow-skill

Git Workflow

Use when establishing branching strategies, implementing Conventional Commits, creating or reviewing PRs, resolving PR review comments, merging PRs (including CI verification, auto-merge queues, and post-merge cleanup), managing PR review threads, merging PRs with signed commits, handling merge conflicts, verifying a merge didn't silently drop changes, syncing a long-diverged branch (e.g. master into integration), rebasing a long-lived branch onto a moved base or splitting one into several PRs, integrating Git with CI/CD, setting up git hooks (lefthook, captainhook, husky, pre-commit), debugging hook-install failures in git worktrees, or working in a bare-repo plus per-branch-worktree layout, including consolidating a directory that holds both a plain clone and a .bare. The pull-request tooling is GitHub-only; references/pull-request-workflow.md carries the GitLab equivalents. Not for creating releases (use github-release) or diagnosing BLOCKED/won't-merge PRs (use github-project).

Use this skill in a project

Open any RiverX project, search the Skills panel for netresearch/file-search-skill/file-search, and install it in one click.

Use this skill