extraction-v2

Extract structured text from exam PDFs and images into v1-schema JSON.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AKCqhzdy/dse-subject-grading --skill extraction-v2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extraction-v2
Source: https://github.com/AKCqhzdy/dse-subject-grading/tree/main/skills/extraction-v2
Command: npx skills add https://github.com/AKCqhzdy/dse-subject-grading --skill extraction-v2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extract structured text from exam-paper PDFs / images (questions, student answers, rubrics) into v1-schema JSON (questions.json / rubrics.json) for downstream grading workflows.

Core Features & Use Cases

  • Converts exam documents into a hierarchical v1 schema suitable for grading tools; outputs include questions.json and rubrics.json with optional image data alignment.
  • Embeds [IMAGE_DATA] tokens in content when visuals matter and provides aligned images metadata to export page images later.
  • Maintains compatibility with legacy extraction workflows via a symlinked scripts path and a pluggable prompt module.

Quick Start

Run the extraction-v2 pipeline on a PDF or directory to produce questions.json and rubrics.json and review the wrapped paper envelope artifacts in the outputs.

Frequently Asked Questions about extraction-v2

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

FAQPage Schema
How do I extract structured data from exam PDFs for automated grading?

To extract structured data from exam PDFs, this pipeline reads questions, student answers, and rubrics, converting them into v1-schema JSON files (questions.json and rubrics.json) for downstream grading workflows. It processes both single and multi-PDF inputs.

Can I extract questions and rubrics from scanned exam images instead of PDFs?

Yes, you can extract questions and rubrics from images as well as PDFs. The pipeline supports both formats, embedding [IMAGE_DATA] tokens in the content when visuals matter and providing aligned images metadata to export page images later.

How does the extraction process handle exam papers containing diagrams or figures?

The extraction process handles diagrams by embedding [IMAGE_DATA] tokens directly into the structured text content when visuals matter. It also generates aligned images metadata, allowing you to export and reference the relevant page images later.

What is the v1-schema JSON format used for exam paper extraction?

The v1-schema JSON format is a hierarchical structure that organizes extracted exam content into questions.json and rubrics.json. This standardized format ensures compatibility with downstream grading tools and legacy extraction workflows.

How do I configure a multi-PDF extraction run for batch exam processing?

You configure multi-PDF extraction runs using YAML files. This allows you to define processing parameters for batch exam processing, while the pipeline maintains compatibility with legacy workflows via a symlinked scripts path and pluggable prompt module.

Does this exam extraction pipeline work with legacy grading systems?

Yes, the exam extraction pipeline works with legacy grading systems by maintaining compatibility through a symlinked scripts path and a pluggable prompt module. It wraps results in a paper envelope for validation and downstream use.