batch-claude-runner

name	batch-claude-runner
disable-model-invocation	true
description	Run Claude programmatically against collections of files in the codebase. Use for batch analysis: scrubbing sensitive data, auditing style violations, security reviews.

Batch Claude Runner

Runs Claude against batches of files, collecting structured findings into a summary report.

Quick Start

# Basic usage
python .claude/skills/batch-claude-runner/scripts/batch_claude_runner.py \
  --pattern "**/*.py" \
  --prompt "Check for hardcoded credentials or API keys."

# See all options
python .claude/skills/batch-claude-runner/scripts/batch_claude_runner.py --help

Key Options

• --pattern / -p: Glob pattern for files (required, repeatable)
• --exclude / -e: Exclude pattern (repeatable)
• --prompt: Analysis prompt
• --batch-size / -b: Files per batch (default: 10)
• --max-batches / -m: Limit batches (for testing)
• --dry-run: Preview files without running
• --output json: Machine-readable output

Notes

• Claude reads files via its Read tool and can make edits if prompted
• Structured JSON output is enforced automatically via --json-schema
• Use --dry-run first to verify file selection