# Search Files

> Recursively search for files and directories matching a pattern. The patterns should be glob-style patterns that match paths relative to the working directory. Use pattern like '*.ext' to match files in current directory, and '**/*.ext' to match files in all subdirectories. Returns full paths to all matching items. Great for finding files when you don't know their exact location. Only searches within allowed directories.

- Skill: `xiaobai1017/search-files` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xiaobai1017/search-files`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaobai1017/search-files/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiaobai1017 (https://skillmd.com/u/xiaobai1017)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xiaobai1017/search-files

---


# Search Files

Recursively search for files and directories matching a pattern. The patterns should be glob-style patterns that match paths relative to the working directory. Use pattern like '*.ext' to match files in current directory, and '**/*.ext' to match files in all subdirectories. Returns full paths to all matching items. Great for finding files when you don't know their exact location. Only searches within allowed directories.

## Purpose

This skill provides access to the MCP tool `search_files`. It allows you to recursively search for files and directories matching a pattern. the patterns should be glob-style patterns that match paths relative to the working directory. use pattern like '*.ext' to match files in current directory, and '**/*.ext' to match files in all subdirectories. returns full paths to all matching items. great for finding files when you don't know their exact location. only searches within allowed directories..

## Parameters

The tool accepts the following parameters:

### `path`
**Required**
- **Type**: `string`
- **Description**: No description provided

### `pattern`
**Required**
- **Type**: `string`
- **Description**: No description provided

### `excludePatterns`
*Optional*
- **Type**: `array`
- **Description**: No description provided


## Usage Instructions

To use this tool:

1. **Prepare the parameters** according to the schema above
2. **Invoke the MCP tool** `search_files` with the prepared parameters
3. **Process the result** returned by the tool

## Example

```json
{
  "path": "example_value",
  "pattern": "example_value",
  "excludePatterns": {}
}
```

## Expected Output

The tool returns data with the following structure:

- **content** (`string`): No description provided


## Notes

- This skill requires an active MCP connection to the server providing the `search_files` tool
- Ensure the MCP server is properly configured and running before attempting to use this tool
- Review the parameter requirements carefully to avoid errors