search_files

Find files by case-insensitive substring matching within five directory levels.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/mufarosean/Parallx --skill search-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search_files
Source: https://github.com/mufarosean/Parallx/tree/main/.parallx/skills/search_files
Command: npx skills add https://github.com/mufarosean/Parallx --skill search-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rapidly locating files or directories by name in large project workspaces is time-consuming and error-prone when done manually; this Skill provides a fast, programmatic way to discover matching paths using substring matching.

Core Features & Use Cases

  • Case-insensitive substring matching: Find files and directories whose names contain the provided pattern regardless of letter case.
  • Scoped search with limits: Search within a specified relative path, limit traversal to five directory levels, and cap results to 50 matches to keep results focused.
  • Use Case: Quickly find all test files, configuration files, or README variations across a repository when preparing refactors, audits, or bulk edits.

Quick Start

Search the workspace for files whose names contain 'config' in the src directory by running search_files with pattern config and path src.

Frequently Asked Questions about search_files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find files by name pattern across a large project workspace?

To find files across a project workspace, use case-insensitive substring matching against file names. This returns relative paths up to a maximum of fifty matches, enabling rapid codebase navigation and content discovery for bulk edits or audits.

Can I search for files within a specific subdirectory like src?

Yes, you can search within a specific subdirectory by specifying a relative path such as src. The search traverses up to five directory levels deep from that location to locate matching files and keep results scoped to your target area.

What is the maximum number of results returned when searching the filesystem?

The maximum number of results returned is fifty matches, and the traversal enforces a depth limit of five directory levels. These constraints are applied to maintain performance and keep search results focused on relevant files.

Does file search support case-insensitive substring matching?

Yes, file search supports case-insensitive substring matching, meaning it locates files and directories whose names contain your provided pattern regardless of letter case, which is useful for finding variations like Config or config.

What are the limitations of recursive file search in a large codebase?

Recursive file search limitations include a strict depth limit of five directory levels and a cap of fifty returned results. If your workspace is deeply nested or contains more matching files, some results will be excluded for performance reasons.