What problem does it solve?
Codebase exploration often requires reading multiple files that share a common pattern. The traditional method of searching, then reading each file individually, is slow and inefficient, consuming many LLM round-trips. This Skill streamlines the process into a single atomic operation.
Core Features & Use Cases
- Atomic File Discovery & Read: Combines finding files by pattern and reading their contents into a single, optimized operation.
- Significant Performance Boost: Achieves 50-70% time savings and reduces LLM round-trips from 1+N to 2-3 for reading 3+ files.
- Flexible Filtering: Supports pattern matching, file type filters (
--type java), and limits on the number of files (--max-files).
- Contextual Output: Provides combined file contents with line numbers, truncation indicators, and size warnings for large outputs.
- Use Case: When you need to understand how a specific
FormattingRule is implemented across your Java codebase, use this Skill to find all relevant files and read their contents in one go, giving you a comprehensive overview without tedious manual steps.
Quick Start
To find and read Java files containing "FormattingRule":
/workspace/main/.claude/scripts/batch-read.sh "FormattingRule"
--type java
--max-files 5