A high-performance utility for finding files by name and searching code content using the power of fd and ripgrep.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install file-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install file-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is File Search?
The File Search skill is a specialized toolset designed to give your AI agent deep visibility into local file systems and project repositories. By utilizing the incredible speed of the fd and ripgrep (rg) binaries, this skill allows for near-instantaneous file location and content extraction, which is critical for complex development tasks within Openclaw Skills.
Whether you are managing a massive monorepo or just trying to find a specific configuration file, this skill provides the necessary bridge between agent logic and raw disk data. It is built for developers who require precision and performance when scanning codebases for patterns, keywords, or specific file types.
File Search Use Cases
- Rapidly locating source files across nested directory structures based on regex patterns.
- Performing code audits by searching for specific markers like TODO, FIXME, or deprecated API calls.
- Filtering searches to specific file types, such as finding all Rust (.rs) or configuration files.
- Contextual code exploration by retrieving surrounding lines of code for specific search hits.
How File Search Works
- The skill accepts search parameters such as a filename pattern or a regex content string from the agent.
- For filename-based queries, it invokes the fd binary to perform a fast, multi-threaded search of the directory tree.
- For content-based queries, it executes ripgrep to scan file interiors while respecting ignore rules.
- The resulting file paths and matching text segments are aggregated and returned to the Openclaw Skills environment for processing.
File Search Setup
To enable this skill, you must have the underlying search binaries installed on your host system. For users on Fedora or RHEL-based distributions, use the following command:
sudo dnf install fd-find ripgrep
Once installed, Openclaw Skills will automatically detect the fd and rg binaries and enable the search functionalities.
File Search Data Schema & Taxonomy
The skill returns structured search results based on the operation type:
| Data Type | Tool Used | Description |
|---|---|---|
| File Paths | fd | A list of absolute or relative strings pointing to found files. |
| Content Matches | rg | An array of objects containing file paths, line numbers, and matching text. |
| Context Snippets | rg | Detailed output including lines before and after the match for better code understanding. |
File Search Advanced Features
- Smart filtering that respects .gitignore and hidden file rules by default.
- Language-specific searching to narrow down content results to relevant source code files.
- Support for glob patterns and complex regular expressions for sophisticated discovery.
- High-performance execution designed for low-latency interactions within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Email Send Skill
A lightweight utility for sending emails via SMTP using msmtp without the need for a full mail client.
Docker Ctl
An essential utility for managing and inspecting Podman containers, logs, and images directly from your AI agent.
DNS Lookup
A networking utility that enables AI agents to perform DNS queries and reverse lookups using the industry-standard dig tool.
Clipboard
Integrate your Linux system clipboard with AI workflows using xclip and Openclaw Skills.
Geo IP
A streamlined utility to retrieve city, region, country, and ISP information for any IP address using the ipinfo.io API.
Git Helper
A specialized AI skill designed to simplify and automate common Git version control operations through optimized command wrappers.