spec-splitter

Split construction project manual PDFs into CSI-formatted specification section files with extracted text.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/robikscube/SJ-skills-sandbox --skill spec-splitter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-splitter
Source: https://github.com/robikscube/SJ-skills-sandbox/tree/main/Skill-List/claude-code-construction/spec-splitter
Command: npx skills add https://github.com/robikscube/SJ-skills-sandbox --skill spec-splitter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdfplumber, pymupdf, PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Construction project teams frequently work with bound, multi-hundred-page project manuals that are difficult to navigate and search, leading to significant wasted time locating specific specification requirements for tasks like submittal reviews, material sourcing, and code compliance checks.

Core Features & Use Cases

  • Spec PDF Splitting: Automatically splits bound project manual PDFs into individual CSI-formatted specification section files with standardized naming conventions for easy navigation.
  • Text Extraction & Quality Assurance: Extracts searchable text from each split spec section, runs automated quality assessments, and applies repair logic or vision-based fallback extraction for low-quality outputs to ensure downstream workflows function correctly.
  • Use Case: For a 600-page commercial construction project manual, this skill separates each spec section (e.g., 03 30 00 Cast-in-Place Concrete) into its own navigable PDF and extracts clean, searchable text for use in submittal log generation and specification research.

Quick Start

Use the spec-splitter skill to split the bound project manual PDF 'office-building-project-manual.pdf' into individual spec section files and extract searchable text from each section.

Frequently Asked Questions about spec-splitter

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

FAQPage Schema
How do I split a bound construction project manual PDF into individual spec sections?

Splitting a bound construction project manual PDF into individual spec sections is done by automatically parsing the document into CSI-formatted files with standardized naming conventions. It processes each multi-hundred-page manual and outputs navigable individual specification PDFs.

How do I extract searchable text from construction specification PDFs for submittal log generation?

Extracting searchable text from construction specification PDFs is handled by parsing each split spec section and running automated quality assessments. It applies repair logic or vision-based fallback extraction for low-quality outputs to ensure clean text for downstream tasks like submittal log generation.

What is a CSI-formatted specification section file in construction project manuals?

A CSI-formatted specification section file is an individual document extracted from a bound project manual, identified by standardized codes like 03 30 00 Cast-in-Place Concrete. This splitting creates navigable files required for construction management workflows.

Does pdfplumber work with PyMuPDF to parse and assess extraction quality for construction PDFs?

pdfplumber works with PyMuPDF to parse PDF content and assess extraction quality for construction project manuals. They are the required dependencies used to produce structured manifest and index files for project workspace integration.

Why does text extraction fail on low-quality scanned construction PDFs and how is it repaired?

Text extraction fails on low-quality scanned construction PDFs due to poor character recognition, but this tool runs automated quality assessments and applies repair logic or vision-based fallback extraction to ensure the output text remains searchable and clean.

Can I use the spec-splitter skill for a 600-page commercial construction project manual?

You can use the spec-splitter skill for a 600-page commercial construction project manual to separate each spec section into its own navigable PDF and extract clean, searchable text for specification research and code compliance checks.