eightforge-extraction-trace-debugger

Trace document extraction bugs from source files through normalization, persistence, and UI rendering.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/EricAnalysis/eightforge-os --skill eightforge-extraction-trace-debugger-ericanalysis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eightforge-extraction-trace-debugger
Source: https://github.com/EricAnalysis/eightforge-os/tree/main/docs/skills/eightforge-extraction-trace-debugger
Command: npx skills add https://github.com/EricAnalysis/eightforge-os --skill eightforge-extraction-trace-debugger-ericanalysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Document intelligence pipelines often produce mismatches between what a source document says and what appears in the UI, and finding where the divergence happens is slow and error-prone. This Skill provides a bounded investigation workflow that pinpoints the first divergence between source truth, extracted artifacts, canonical assembly, and rendered surfaces. ## Core Features & Use Cases - End-to-End Pipeline Tracing: Walks the full path from source file through parser output, normalized models, persisted facts, view model assembly, and UI render conditions. - Sibling Surface Comparison: Compares Extraction, Evidence, Fact Ledger, and Validator surfaces that should agree, to isolate which layer consumes the wrong data shape. - Domain-Specific Playbooks: Covers contract pricing and rate schedule assembly, invoice totals and line items, transaction_data spreadsheet summaries, evidence anchors, and OCR/table noise. - Use Case: An invoice total renders correctly in the Extraction tab but is missing in the Fact Ledger. Use this Skill to trace whether persistence stored the right data, the view model built the wrong shape, or a render condition blocked the section, then apply the smallest fix at the first true divergence. ## Quick Start Use the eightforge-extraction-trace-debugger skill to trace why the rate schedule rows shown in the Evidence tab do not match the rows rendered in the Extraction tab.

Frequently Asked Questions about eightforge-extraction-trace-debugger

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

FAQPage Schema
How do I debug a mismatch between extracted data and what the UI renders?▼

Trace the pipeline in order: source file, parser output, normalized model, persisted facts, view model assembly, then UI props and render conditions. Compare sibling surfaces that should agree and fix the first true divergence with the smallest local change.

How to trace invoice total extraction errors in a document pipeline?▼

Distinguish cover-sheet billed totals from line totals, rates, and quantities, then verify each layer from parser output through persistence to the view model. Check whether the UI consumes a raw shape while a cleaned assembly row exists elsewhere.

Why does the Extraction tab show different rows than the Evidence tab?▼

This usually means the view model builds both raw and clean rows but one surface consumes the wrong shape, or normalization kept noisy OCR text. Fix the local consumer or view-model handoff rather than refactoring the pipeline.

What should be preserved when fixing document extraction bugs?▼

Preserve evidence anchors including source document, page, bbox, row, sheet, and extraction version wherever available. Keep one canonical truth layer and avoid duplicating truth logic in UI, validators, or persistence helpers.

When should OCR uncertainty block normalization of extracted text?▼

Uncertain OCR or table text should stay inspectable and never be normalized into authoritative truth without evidence. Surface the uncertainty honestly and keep the source text available for review.