heavy-file-ingestion

Convert heavyweight documents and spreadsheets into markdown or CSV artifacts with indexes.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/robwestz/ob1_workspace --skill heavy-file-ingestion-robwestz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heavy-file-ingestion
Source: https://github.com/robwestz/ob1_workspace/tree/main/skills/heavy-file-ingestion
Command: npx skills add https://github.com/robwestz/ob1_workspace --skill heavy-file-ingestion-robwestz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, openpyxl, pdfplumber, python-docx, python-pptx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents agents from wasting context and cost on raw heavyweight files by converting them into smaller, structured artifacts first.

Core Features & Use Cases

  • Deterministic conversion first: Converts PDFs, DOCX, PPTX, XLSX, CSV, TSV, and plain text into markdown or normalized CSV before analysis.
  • Lightweight indexing: Produces an index with source details, preview lines, stats, warnings, and a recommended next step so the agent can route intelligently.
  • Quality-aware fallbacks: Detects weak extraction, scanned PDFs, and missing dependencies, then signals when to retry, switch converters, or escalate.
  • Reusable workflows: Supports repeatable file ingestion for document review, spreadsheet inspection, slide summarization, and archival extraction tasks.

Quick Start

Ask the skill to convert the attached heavyweight file into a markdown or CSV artifact and then analyze the generated index before reading the converted output.

Frequently Asked Questions about heavy-file-ingestion

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

FAQPage Schema
How do I convert large PDF and spreadsheet files into markdown for AI agents?

Converting large PDF and spreadsheet files into markdown for AI agents requires deterministic conversion of PDFs, DOCX, PPTX, XLSX, and CSV inputs into compact markdown or normalized CSV artifacts before analysis.

What is the best way to reduce token usage when analyzing heavy documents?

The best way to reduce token usage when analyzing heavy documents is to convert them into smaller, structured artifacts first, which prevents agents from wasting context and cost on raw heavyweight files during extraction.

How does document conversion handle scanned PDFs or weak text extraction?

Document conversion handles scanned PDFs or weak text extraction through quality-aware fallbacks that detect poor results, signal warnings in the index, and recommend whether to retry, switch converters, or escalate the task.

Do I need to install markitdown and pdfplumber to convert heavy files?

Yes, you need dependencies like markitdown, pdfplumber, openpyxl, python-docx, and python-pptx installed, as the Skill detects missing dependencies and signals warnings to ensure deterministic file conversion proceeds correctly.

Can I generate an index from multiple spreadsheet files before reading the content?

Yes, you can generate a lightweight index from multiple spreadsheet files that includes source details, preview lines, stats, warnings, and a recommended next step, allowing the agent to route intelligently before reading converted outputs.