fs-search-skill

Search filesystem directories using ls, glob, or grep modes.

356|66|Updated Oct 13, 2025
One-click install
npx skills add https://github.com/zeenie-ai/MachinaOS --skill fs-search-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fs-search-skill
Source: https://github.com/zeenie-ai/MachinaOS/tree/main/server/skills/coding_agent/fs-search-skill
Command: npx skills add https://github.com/zeenie-ai/MachinaOS --skill fs-search-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly locate the right files and snippets in a local codebase or directory when you cannot remember where something lives or what it contains.

Core Features & Use Cases

  • Directory exploration with ls: See folder contents to understand structure before searching deeper.
  • Pattern-based discovery with glob: Match filenames across nested directories using patterns like **/*.py.
  • Content search with grep: Search literal text within selected files, returning matching file locations and lines.
  • Use Case: When you are debugging an issue, you can glob for the relevant module files and then grep for the exact function name or configuration string to jump straight to the source.

Quick Start

Use the fs-search-skill tool in grep mode to search for a specific string like "def main" across a project directory while filtering to only Python files.

Frequently Asked Questions about fs-search-skill

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

FAQPage Schema
How do I search for a specific text string across my codebase?

Search for specific text across your codebase using the grep mode, which locates literal text within files and returns matching file locations and lines. An optional file filter narrows results to specified file types.

What is the best way to find source files by extension in nested directories?

Find source files by extension in nested directories using the glob mode, which matches paths with patterns like **/*.py. This enables rapid discovery of relevant modules across complex folder structures.

Can I list directory contents to understand project structure before searching?

Yes, you can list directory contents to understand project structure before searching deeper using the ls mode. This reveals folder layouts and helps narrow your search scope effectively.

Does the grep search mode support filtering results by file type?

Yes, the grep search mode supports filtering results by file type through the optional file_filter input. This restricts content searches to specific formats, such as searching for a function name only in Python files.

Are there limits on the number of matches returned when using grep?

Yes, there are limits on the number of matches returned when using grep mode. The search results are structured with capped match counts to ensure manageable output when locating text across repositories with many files.