Quiz Generator

# Generate quiz from validated files
python scripts/quiz_generate.py ./course/__cc_validated_files/

# Specify output directory
python scripts/quiz_generate.py ./validated -o ./output/__ccg_Exam/

# Control question counts
python scripts/quiz_generate.py ./validated --mc 20 --sa 10 --tf 10

# Generate specific topic quiz
python scripts/quiz_generate.py ./validated --topic "Chapter 3"

__ccg_Exam/
├── quiz_full.md           # Complete quiz
├── quiz_mc.md             # Multiple choice only
├── quiz_sa.md             # Short answer only
├── quiz_tf.md             # True/false only
└── answer_key.md          # Answer key (separate file)

1. What is the primary function of X?

   a) Option A
   b) Option B
   c) Option C (correct)
   d) Option D

1. Explain the relationship between X and Y.

   _Expected answer: [2-3 sentences about relationship]_

1. Statement about concept X. (True/False)

   Answer: True

python scripts/quiz_generate.py INPUT_DIR [OPTIONS]

Arguments:
  INPUT_DIR             Path to __cc_validated_files/ folder

Options:
  -o, --output DIR      Output directory (default: ../__ccg_Exam/)
  --mc COUNT            Number of multiple choice questions (default: 15)
  --sa COUNT            Number of short answer questions (default: 5)
  --tf COUNT            Number of true/false questions (default: 10)
  --topic TOPIC         Filter to specific topic/chapter
  --difficulty LEVEL    easy|medium|hard (default: medium)
  --format FMT          Output format: markdown|json (default: markdown)
  --seed INT            Random seed for reproducibility
  -j, --json            Output results as JSON

# 1. Extract content from source files
python file_router.py source.pdf --json  # Routes to pdf skill

# 2. PDF skill extracts text to __cc_validated_files/
# (handled by pdf/docx/etc. skills)

# 3. Generate quiz from extracted content
python quiz_generate.py ./__cc_validated_files/ -o ./__ccg_Exam/