batch-read

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