File Search
Fast file and text search across the codebase.
by cfircoo · MIT
The skill
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".
<objective> Execute fast, thorough file and text searches across the codebase using a lightweight haiku agent. Returns precise results with file paths, line numbers, and context — never modifies files. </objective>
<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>
<tips>
- Be specific: "find where UserService is defined" beats "find UserService"
- Include file type hints: "find login handler in Python files"
- Use quotes for exact phrases: search for "database connection pool"
- Scope by directory: "search for auth middleware in src/api/"
- Chain searches: "find all files that import from utils/auth" </tips>
<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>
Use this skill
Connect your agent to the Skill Store MCP server and ask for it by ref: cfircoo/file-search-61594148344.
Details
- Publisher
- cfircoo
- Category
- Software Development › Developer docs & tooling
- License
- MIT
- Updated
- 2026-03-28
References
More from cfircoo
- Manage Skills This skill should be used when the user asks to "create a skill", "build a new skill", "write a S…
- Manage Hooks This skill should be used when the user asks to "create a hook", "add a PreToolUse hook", "debug…
- Create Meta Prompts Create optimized prompts for Claude-to-Claude pipelines with research, planning, and execution st…
- Create Plans Create hierarchical project plans optimized for solo agentic development.