QuickClass Quiz Converter for Openclaw

Install or place the skill in the Openclaw Skills or WorkBuddy skills directory. In WorkBuddy, the typical location is ~/.workbuddy/skills/quickclass-quiz-converter. Set SKILL_DIR to the skill's actual absolute path before running commands. The workflow may also use the related docx, pdf, paddleocr-doc-parsing, and image_understanding capabilities.

Convert an intermediate question file into QuickClass JSON:

python {SKILL_DIR}/scripts/convert_to_quickclass.py \
  --teacher "Teacher Name" \
  --grade "Grade 3 Semester 2" \
  --subject "Mathematics" \
  --task-title "Understanding Circles" \
  --quiz-title "Practice Questions" \
  --input .temp/questions.json \
  --output "teacher_grade_subject_task_title_QuickClass_homework_quiz_title.json"

Extract embedded images from a Word document:

python {SKILL_DIR}/scripts/extract_images.py \
  --input "source_exam.docx" \
  --output-dir .temp/images \
  --mapping .temp/image_mapping.json

Render scanned PDF pages for visual analysis:

python {SKILL_DIR}/scripts/extract_images.py \
  --input "scanned_exam.pdf" \
  --output-dir .temp/page_images \
  --render-pages

Generate a companion Word diagram document for embedded images:

python {SKILL_DIR}/scripts/generate_image_doc.py \
  --mapping .temp/image_mapping.json \
  --images-dir .temp/images \
  --output "teacher_grade_subject_task_QuickClass_homework_quiz_diagrams.docx" \
  --title "Understanding Circles Diagrams"

For scanned PDFs, add --pages-dir .temp/page_images to generate_image_doc.py. The mapping must contain crop and source_page values so the script can crop the relevant diagram from the rendered full-page image.

Intermediate question object

Temporary files

• .temp/questions.json: normalized intermediate question array.
• .temp/images/: extracted embedded image files such as image_1.png.
• .temp/page_images/: high-resolution rendered scanned PDF pages such as page_1.png.
• .temp/image_mapping.json: question-to-image association records.
• Mapping records may include image_file, question_number, page, context, crop, and source_page.
• crop coordinates use percentages and support precise diagram extraction from full-page renders.

Final output

The JSON filename follows {teacher}_{grade}_{subject}_{taskTitle}_QuickClass_homework_{quizTitle}.json. When images exist, a separate labeled Word document is generated because QuickClass JSON does not embed source images. The companion document includes the title, question-number labels, centered original or cropped diagrams, question previews, and explanatory text.