heavy-file-ingestion-claude-code

Convert large PDFs, DOCX, PPTX, XLSX, CSV, and TSV files into compressed markdown and per-sheet CSV artifacts with an index.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/az9713/OB1-byoc-enhanced --skill heavy-file-ingestion-claude-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heavy-file-ingestion-claude-code
Source: https://github.com/az9713/OB1-byoc-enhanced/tree/main/skills/heavy-file-ingestion/variants/claude-code
Command: npx skills add https://github.com/az9713/OB1-byoc-enhanced --skill heavy-file-ingestion-claude-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents Claude Code from wasting model context on heavyweight files by converting large or structured documents into compact, model-friendly artifacts and a lightweight index that guide efficient analysis.

Core Features & Use Cases

  • Deterministic Conversion: Run a bundled converter to produce markdown for documents and per-sheet CSVs for spreadsheets so models analyze compressed text rather than raw binaries.
  • Index-Driven Workflow: Generate and read an index.md first to decide whether to read the extracted artifact, install a missing dependency and retry, or escalate to a stronger model only when necessary.
  • Practical Use Case: Convert a multi-page PDF with tables into indexed markdown and CSVs to quickly summarize contents, extract tables, or produce a compact working copy for downstream analysis.

Quick Start

Convert the file large-report.pdf with the bundled converter, read the generated index, and ask Claude Code to summarize the indexed sections and extracted tables.

Frequently Asked Questions about heavy-file-ingestion-claude-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert large PDF files to markdown for analysis?

To convert large PDF files to markdown, run the bundled deterministic converter script which produces compressed, model-friendly markdown artifacts and a generated index.md to guide further analysis. This prevents wasting model context on raw binaries.

What's the best way to extract tables from large spreadsheets for indexing?

The best way to extract tables from large spreadsheets is using a converter that exports per-sheet CSVs for XLSX, CSV, and TSV files. This creates compact, structured artifacts and an index.md that guide efficient model reads.

Why does Claude Code waste context on large DOCX files?

Claude Code wastes context on large DOCX files because it attempts to process raw binary data directly. Converting heavyweight files into compressed markdown artifacts first prevents this waste and enables index-driven analysis.

Do I need Python installed to convert PPTX files for Claude Code workflows?

Yes, you need Python installed to run the deterministic converter script. The script prefers installed Python dependencies for converting PPTX and other formats, with fallbacks available, saving converted artifacts next to source files.

Can I summarize large PDF content without reading the entire file?

Yes, you can summarize large PDF content by converting it with the bundled script to generate markdown and an index.md. Read the index first to decide which extracted sections or tables to summarize, avoiding full file reads.