adu-pdf-extraction

Extract multi-page construction PDF plan binders into structured JSON manifests.

284|94|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mikeOnBreeze/cc-crossbeam --skill adu-pdf-extraction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adu-pdf-extraction
Source: https://github.com/mikeOnBreeze/cc-crossbeam/tree/main/adu-skill-development/skill/adu-pdf-extraction
Command: npx skills add https://github.com/mikeOnBreeze/cc-crossbeam --skill adu-pdf-extraction

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdftoppm, tesseract, imagemagick, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Construction PDF plan binders are extremely difficult for AI agents to parse because they contain composited multi-page layouts, CAD-rendered text that standard extractors cannot read, diagonal watermarks that pollute text layers, and rasterized Title 24 energy reports with no selectable text. This skill automates the conversion of these binders into structured, queryable formats that agents can navigate efficiently.

Core Features & Use Cases

  • Vision-First Extraction: Leverages Claude Vision as the primary extraction method because it reliably handles drawing pages, text-heavy sheets, and rasterized reports where pdftotext, pdfplumber, and Tesseract all fail.
  • Structured Manifest Routing: Produces a JSON binder manifest with per-page metadata, key content arrays, topic keywords, and spatial drawing zones so agents can route corrections letters to exact sheets without loading every page into context.
  • Hybrid Numeric Accuracy: Combines vision extraction with Tesseract OCR cross-referencing to prevent vision hallucinations on critical numeric values like dimensions, PSI, and percentages.
  • Use Case: A contractor uploads a 20-page ADU plan set and a city corrections letter; the skill extracts all pages into a searchable manifest so the agent can match each correction item to the specific sheet, drawing zone, and exact specification needed for the response.

Quick Start

Use the adu-pdf-extraction skill to process the uploaded construction plan PDF and generate a structured binder manifest for permit review.

Frequently Asked Questions about adu-pdf-extraction

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

FAQPage Schema
How do I extract text from construction PDF plans when standard PDF extractors fail on CAD drawings?

Extracting text from construction PDF plans requires a vision-first approach because standard extractors cannot parse composited multi-page layouts, diagonal watermarks, or CAD-rendered text. Claude Vision reliably handles drawing pages and rasterized reports by generating page PNGs and per-page markdown for agent navigation.

What is the best way to structure an ADU permit plan binder for AI agent routing?

Structuring an ADU permit plan binder involves generating a JSON manifest with per-page metadata, topic keywords, and spatial drawing zones. This allows agents to route corrections letters to exact sheets and drawing zones without loading the entire multi-page construction PDF into context.

Do I need Tesseract and ImageMagick to process California ADU permit PDFs?

Processing California ADU permit PDFs requires Tesseract OCR and ImageMagick alongside pdftoppm. These dependencies convert binder pages into PNGs and cross-reference OCR text with vision extraction to prevent hallucinations on critical numeric values like dimensions and PSI.

How does OCR cross-referencing prevent vision hallucinations on construction dimensions?

OCR cross-referencing prevents vision hallucinations by combining Claude Vision extraction with Tesseract OCR text validation. This hybrid numeric accuracy approach ensures critical values like dimensions, PSI, and percentages extracted from construction plan binders are verified against the rasterized text layer.

Can I match city corrections letters to specific architectural sheets without loading every PDF page?

Matching city corrections letters to specific architectural sheets uses the structured JSON binder manifest containing per-page metadata and spatial drawing zones. Agents query this manifest to route each correction item directly to the exact sheet and specification needed without loading every page.

Why does pdftotext return garbage or missing text from Title 24 energy reports?

pdftotext returns missing text from Title 24 energy reports because these documents are rasterized images with no selectable text layer. The adu-pdf-extraction skill uses Claude Vision as the primary extraction method to process these rasterized reports where standard text extractors fail.