What problem does it solve?
Agents often reach for raw shell commands like grep or find when searching filesystems, producing slow, unstructured, or gitignore-unaware results. This Skill teaches the correct split between structured search tools (terminal_rg for content, terminal_glob for file names) and terminal_exec for predicate queries, tree views, and stat info.
Core Features & Use Cases
- Content search with terminal_rg: ripgrep-backed, gitignore-aware search with flags for case-insensitivity, context lines, hidden files, multiline regex, file-type filters, and glob scoping across project trees, /var/log, /etc, and home directories.
- File lookup with terminal_glob: find files by name or glob pattern with automatic pattern widening, recursive matching, and optional inclusion of ignored or hidden files.
- Predicate queries via terminal_exec: reference tables for find predicates covering mtime, size, type, permissions, and composition with AND/OR logic.
- Use Case: An agent debugging a production issue searches /var/log case-insensitively for "error" with context lines, then locates all YAML configs under /etc, then finds log files modified in the last day larger than 10MB — each routed to the correct tool.
Quick Start
Ask the agent to find all Python files containing TODO in the project and list log files under /var/log modified in the last two days.