reading-pdfs

Convert PDFs to Markdown using Mistral OCR with local caching.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/dzackgarza/ai --skill reading-pdfs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reading-pdfs
Source: https://github.com/dzackgarza/ai/tree/main/opencode/skills/reading-pdfs
Command: npx skills add https://github.com/dzackgarza/ai --skill reading-pdfs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when reading a PDF — converts to markdown via Mistral OCR with local caching.

Core Features & Use Cases

  • Local caching of extracted Markdown under ~/pdfs to avoid re-processing of the same document.
  • OCR-powered conversion of PDFs (including arXiv papers) to Markdown with deterministic outputs.
  • Structured workflow: download if missing, process with Mistral OCR, and return Markdown content.

Quick Start

Provide the path to a PDF and run the OCR workflow to produce a cached Markdown version in the local pdfs cache.

Frequently Asked Questions about reading-pdfs

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

FAQPage Schema
How do I convert a PDF to Markdown offline using OCR?

To convert a PDF to Markdown offline, this Skill applies Mistral OCR to the document and caches the extracted text locally. It checks the ~/pdfs directory for existing Markdown to avoid re-processing, downloading missing PDFs like arXiv papers automatically before returning the content.

What is needed to run Mistral OCR for PDF conversion?

Running Mistral OCR for PDF conversion requires a Python environment with the mistralai library installed. You must also set the MISTRAL_API_KEY environment variable to authenticate the OCR requests and successfully generate the Markdown output.

Can I avoid re-processing the same arXiv paper if I already converted it?

Yes, you can avoid re-processing an arXiv paper because the Skill stores original PDFs and generated Markdown in a local cache under ~/pdfs. It checks this cache before applying OCR, returning the existing Markdown immediately if found.

Does this PDF to Markdown conversion work for academic papers?

Yes, this PDF to Markdown conversion works for academic papers. The workflow explicitly supports downloading and processing arXiv papers, applying Mistral OCR to extract structured Markdown content from the PDFs for research purposes.

What happens to the original PDF file after OCR extraction?

After OCR extraction, the original PDF file is stored alongside the generated Markdown content in the local cache directory at ~/pdfs. This ensures both the source document and the extracted Markdown remain accessible for future offline reference.