Skip to main content
skill CX Codex

pdf-construction — Claude Code skill: what it does, how to install

pdf-construction extracts data from RFI forms, splits drawing sets by sheet, parses CSI specifications, and builds submittal packages from construction PDFs.

MIT 126 installs ★ 434 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-construction -a claude-code
Open on GitHub

What pdf-construction does

The skill adapts PDF manipulation routines to construction paperwork. It provides Python scripts that parse Request for Information documents via regex, pull divisions from CSI MasterFormat specs, and cut large drawing packages into individual single-sheet PDF files named by drawing numbers.

It also handles submittal packaging: it merges cover sheets, product data, and shop drawings into a single deliverable with clickable bookmarks. Extracted metadata can be fed directly into tracking spreadsheets through pandas.

You must have python3 along with pypdf, pdfplumber, and reportlab installed in your environment; without these packages, the scripts cannot run.

What it helps with

  • extract structured metadata from construction RFI documents
  • assemble submittal packages with bookmarks from multiple PDFs
  • split full drawing packages into standalone sheet files
  • parse CSI MasterFormat specification divisions into text sections

Example prompts for the agent

  • Extract all fields from RFI_045.pdf and append the record to RFI_Log.xlsx
  • Split drawings_set.pdf into individual files using sheet numbers from the title block
  • Build a submittal package by combining cover.pdf with the shop drawing files

How to install pdf-construction

1Skills CLI (Vercel)

npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-construction -a claude-code

2Manually: put the files in place

~/.claude/skills/pdf-construction/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pdf-construction/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pdf-construction

How do I install pdf-construction in Claude Code?

Run npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill pdf-construction -a claude-code. The skill file will be placed at ~/.claude/skills/pdf-construction/SKILL.md.

What does pdf-construction do?

It processes construction PDF files by extracting data from RFIs, dividing drawing sets by sheet number, and assembling bookmarked submittal documents.

What dependencies are required?

The skill relies on python3 and three Python packages: pypdf, pdfplumber, and reportlab. Install them using pip install pypdf pdfplumber reportlab.

Source text

SKILL.md · MIT
---
name: "pdf-construction"
description: "PDF processing for construction documents: RFIs, submittals, specifications, drawing packages. Extract data, merge packages, fill forms."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "📄", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# PDF Processing for Construction

## Overview

Adapted from Anthropic's PDF skill for construction document workflows.

## Construction Use Cases

### 1. RFI Processing
Extract structured data from Request for Information documents.

```python
from pypdf import PdfReader
import re

def extract_rfi_data(pdf_path: str) -> dict:
    """Extract RFI fields from PDF."""
    reader = PdfReader(pdf_path)
    text = ""
    for page in reader.pages:
        text += page.extract_text()

    # Parse common RFI fields
    rfi_data = {
        'rfi_number': re.search(r'RFI\s*#?\s*(\d+)', text),
        'subject': re.search(r'Subject:?\s*(.+?)(?:\n|$)', text),
        'from': re.search(r'From:?\s*(.+?)(?:\n|$)', text),
        'to': re.search(r'To:?\s*(.+?)(?:\n|$)', text),
        'date': re.search(r'Date:?\s*(\d{1,2}[/-]\d{1,2}[/-]\d{2,4})', text),
        'spec_section': re.search(r'Spec(?:ification)?\s*Section:?\s*(.+?)(?:\n|$)', text),
        'drawing_ref': re.search(r'Drawing\s*(?:Ref)?:?\s*(.+?)(?:\n|$)', text),
    }

    return {k: v.group(1) if v else None for k, v in rfi_data.items()}
```

### 2. Submittal Package Creation
Merge multiple PDFs into organized submittal packages.

```python
from pypdf import PdfWriter, PdfReader
from pathlib import Path

def create_submittal_package(
    cover_sheet: str,
    product_data: list,
    shop_drawings: list,
    output_path: str
) -> str:
    """Create organized submittal package."""
    writer = PdfWriter()

    # Add cover sheet
    writer.append(cover_sheet)

    # Add bookmarked sections
    page_num = len(PdfReader(cover_sheet).pages)

    # Product Data section
    writer.add_outline_item("Product Data", page_num)
    for pdf in product_data:
        writer.append(pdf)
        page_num += len(PdfReader(pdf).pages)

    # Shop Drawings section
    writer.add_outline_item("Shop Drawings", page_num)
    for pdf in shop_drawings:
        writer.append(pdf)
        page_num += len(PdfReader(pdf).pages)

    with open(output_path, "wb") as output:
        writer.write(output)

    return output_path
```

### 3. Specification Extraction
Extract specification sections for analysis.

```python
import pdfplumber

def extract_spec_sections(pdf_path: str) -> dict:
    """Extract specification sections by division."""
    sections = {}

    with pdfplumber.open(pdf_path) as pdf:
        current_section = None
        current_text = []

        for page in pdf.pages:
            text = page.extract_text()

            # Match CSI MasterFormat sections
            for line in text.split('\n'):
                # Match section headers like "03 30 00 - Cast-in-Place Concrete"
                match = re.match(r'^(\d{2}\s?\d{2}\s?\d{2})\s*[-–]\s*(.+)$', line)
                if match:
                    if current_section:
                        sections[current_section] = '\n'.join(current_text)
                    current_section = match.group(1).replace(' ', '')
                    current_text = [match.group(2)]
                elif current_section:
                    current_text.append(line)

        if current_section:
            sections[current_section] = '\n'.join(current_text)

    return sections
```

### 4. Drawing Sheet Extraction
Split drawing packages by sheet.

```python
def split_drawing_package(pdf_path: str, output_dir: str) -> list:
    """Split drawing package into individual sheets."""
    reader = PdfReader(pdf_path)
    output_dir = Path(output_dir)
    output_dir.mkdir(exist_ok=True)

    sheets = []
    for i, page in enumerate(reader.pages):
        # Extract sheet number from page (if text-based)
        text = page.extract_text()
        sheet_match = re.search(r'([A-Z]+[-]?\d+)', text[:500])
        sheet_name = sheet_match.group(1) if sheet_match else f"Page_{i+1:03d}"

        writer = PdfWriter()
        writer.add_page(page)

        output_file = output_dir / f"{sheet_name}.pdf"
        with open(output_file, "wb") as f:
            writer.write(f)

        sheets.append(str(output_file))

    return sheets
```

## Integration with DDC Pipeline

```python
# Example: Process RFI and add to tracking spreadsheet
import pandas as pd

# Extract RFI data
rfi_data = extract_rfi_data("RFI_045.pdf")

# Load existing tracker
tracker = pd.read_excel("RFI_Log.xlsx")

# Add new entry
new_row = pd.DataFrame([rfi_data])
tracker = pd.concat([tracker, new_row], ignore_index=True)

# Save updated tracker
tracker.to_excel("RFI_Log.xlsx", index=False)
```

## Dependencies

```bash
pip install pypdf pdfplumber reportlab
```

## Resources

- **Original**: Anthropic PDF Skill
- **PyPDF Docs**: https://pypdf.readthedocs.io/
- **PDFPlumber**: https://github.com/jsvine/pdfplumber

© datadrivenconstruction · MIT · datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

Similar skills

All skills for Writing and docs →

From the same set156

The whole set →
submittal-tracker submittal-tracker tracks construction submittals across reviews, revisions, and approval stages. Keeps document logs organized and flags overdue items. CX Codex +1 127installs contract-clause-analyzer The contract-clause-analyzer skill parses construction contract clauses, classifies them by type, flags risks, and extracts deadlines and payment amounts. Requires Python 3. CX Codex +1 127installs meeting-minutes-generator The meeting-minutes-generator skill generates structured meeting minutes for construction projects, tracking decisions and action items. Requires Python 3. CX Codex +1 126installs bim-visual-programming-automation bim-visual-programming-automation automates BIM tasks with Dynamo Python nodes and Revit API routines. Extracts element quantities, calculates take-offs, and batch updates parameters. CX Codex +1 126installs punch-list-manager punch-list-manager is a Claude Code skill that tracks construction deficiencies from site walks through final acceptance, including assignments, deadlines, photos, and verification. CX Codex +1 125installs llm-document-extraction The llm-document-extraction skill parses unstructured PDFs—RFIs, submittals, contracts, specifications—into structured JSON and Excel. Uses LLMs to analyze text, classify document types, and extract fields automatically. CX Codex +1 125installs quality-control-workflow The quality-control-workflow skill structures construction quality control from inspection planning to defect resolution, with records for findings, NCRs, and specification checks. CX Codex +1 125installs 4d-simulation 4d-simulation links building models to project schedules and visualizes construction sequences day by day. Detects scheduling conflicts and analyzes work phases. CX Codex +1 125installs

Project sponsors

Companies that keep this analytics open