Agent skill

file-search

Fast file and text search across the codebase. Use when you need to find files by name, search code by content, locate definitions, find usages/imports, or explore project structure. Triggers on "find file", "search for", "where is", "grep for", "locate", "find definition", "find usage", "search codebase", "find all references".

Stars 16
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/cfircoo/claude-code-toolkit/tree/main/skills/file-search

SKILL.md

<search_modes> This skill handles all search types automatically based on input:

Input Pattern Search Mode What Happens
File name or glob pattern File search Finds files by name/pattern across the project
Text string or regex Content search Greps file contents for matches
Function/class/type name Definition search Finds where something is defined + its signature
"usages of X" / "who calls X" Usage search Finds all imports and call sites
"imports of X" Import search Finds all files that import a module
Directory path or "structure" Structure exploration Maps directory layout and key files
"related to X" Related files Finds dependencies and dependents of a file

The agent runs multiple search strategies in parallel and cross-references results for completeness. </search_modes>

<success_criteria>

  • Returns file paths with line numbers for all matches
  • Exhausts multiple search strategies before reporting "not found"
  • Results are ordered by relevance
  • No false positives — every result was verified by a tool call </success_criteria>

Didn't find tool you were looking for?

Be as detailed as possible for better results