Read Optimizer

Optimizes file reading by smartly extracting head/tail lines, matching patterns, or showing git diffs to minimize token use and latency.

SKILL: Read Optimizer (read-optimizer)

Description

Optimizes file reading operations by providing smarter read strategies (head/tail/grep/diff) to reduce token usage and latency. Use this when you need to inspect large files efficiently without dumping the entire content.

Usage

Smart Read (Head + Tail)

Reads the first N lines and the last N lines of a file. Good for logs or large docs.

node skills/read-optimizer/index.js --file <path> --mode smart --lines 100

Grep Read (Focus)

Reads lines matching a pattern (regex supported).

node skills/read-optimizer/index.js --file <path> --mode grep --pattern "error|exception"

Diff Read (Changes)

Reads only the lines changed since the last git commit (if in a git repo).

node skills/read-optimizer/index.js --file <path> --mode diff

Options

• --file <path>: Path to the file.
• --mode <smart|grep|diff>: Operation mode (default: smart).
• --lines <number>: Number of lines for head/tail (default: 50).
• --pattern <string>: Regex pattern for grep mode.
• --context <number>: Context lines for grep (default: 2).