Quiz Generator for Intelligent Textbooks Skill

Quiz Generator for Intelligent Textbooks

Version: 0.3

Overview

For each markdown chapter, generate interactive multiple-choice quizzes for textbook chapters with quality distractor analysis.
Generate quality reports in markdown format.
Update mkdocs.yml navigation to include quizzes and reports.
NEW in v0.3: Support parallel execution for faster generation across multiple chapters.

Purpose

This skill automates quiz creation for intelligent textbooks by analyzing chapter content to generate contextually relevant multiple-choice questions. Each quiz is aligned to specific concepts from the learning graph, distributed across Bloom's Taxonomy cognitive levels, and formatted using mkdocs-material question admonition format with upper-alpha (A, B, C, D) answer choices. The skill ensures quality distractors, balanced answer distribution, and comprehensive explanations for educational value.

When to Use This Skill

Use this skill after:

Chapter content has been generated or written (1000+ words per chapter)
Learning graph exists with concept dependencies
Glossary is available (recommended for terminology questions)

Trigger this skill when:

Creating quizzes for new chapters
Updating quizzes after content revisions
Building comprehensive quiz bank for entire textbook
Exporting quiz data for LMS or chatbot integration

The skill can run:

Parallel mode (default): Multiple chapters processed concurrently for faster generation
Sequential mode: Chapter by chapter processing
Single chapter mode: Generate quiz for one specific chapter

Execution Modes

Parallel Mode (Default for 4+ chapters)

When generating quizzes for 4 or more chapters, use parallel execution:

| Aspect | Sequential | Parallel | |--------|------------|----------| | Agents | 1 | 4-6 concurrent | | Wall-clock time | ~10 minutes (23 chapters) | ~2-3 minutes | | Total tokens | Same | Same |

Sequential Mode

Use for:

Fewer than 4 chapters
Debugging or troubleshooting
When explicit sequential processing is requested

Single Chapter Mode

Use for:

Updating one quiz after content revision
Testing quiz format before batch generation

Workflow

Phase 1: Setup (Sequential)

This phase runs once before any quiz generation, reading shared context that all agents will need.

Step 1.1: Capture Start Time

date "+%Y-%m-%d %H:%M:%S"

Log the start time for the session report.

Step 1.2: Indicate Skill Running

Notify the user: "Quiz Generator Skill v0.3 running in [parallel/sequential] mode."

Step 1.3: Read Shared Context

Read and cache these files for all agents:

Course Description (docs/course-description.md)
- Extract target audience and reading level
- Note Bloom's Taxonomy learning outcomes
Learning Graph (docs/learning-graph/learning-graph.csv or similar)
- Load concept list with dependencies
- Calculate concept centrality for prioritization
Glossary (docs/glossary.md)
- Load term definitions for terminology questions
- Note which concepts have glossary entries
Chapter List (scan docs/chapters/ directory)
- Enumerate all chapter directories
- Count words per chapter for readiness assessment

Step 1.4: Assess Content Readiness

Calculate content readiness score (1-100) for each target chapter:

Quality Checks:

1. Chapter word count:

2000+ words = excellent (20 pts)
1000-1999 words = good (15 pts)
500-999 words = basic (10 pts)
<500 words = insufficient (5 pts)

2. Example coverage:

60%+ concepts with examples = excellent (20 pts)
40-59% = good (15 pts)
20-39% = basic (10 pts)
<20% = insufficient (5 pts)

3. Glossary coverage:

80%+ chapter concepts defined = excellent (20 pts)
60-79% = good (15 pts)
40-59% = basic (10 pts)
<40% = insufficient (5 pts)

4. Concept clarity:

Clear explanations for all concepts (20 pts)
Most concepts clear (15 pts)
Some unclear concepts (10 pts)
Many unclear concepts (5 pts)

5. Learning graph alignment:

All chapter concepts mapped (20 pts)
Most mapped (15 pts)
Some mapped (10 pts)
Few mapped (5 pts)

Content Readiness Ranges:

90-100: Rich content, excellent quiz quality possible
70-89: Good content, solid quiz possible
50-69: Basic content, limited quiz possible
Below 50: Insufficient content for quality quiz

User Dialog Triggers:

Score < 60: Ask "Chapter [X] has limited content ([N] words). Generate shorter quiz or skip?"
No glossary: Ask "No glossary found. Definition questions will be limited. Proceed?"
Concept gaps: Ask "[N] concepts in chapter not in learning graph. Continue with available concepts?"
No learning outcomes: Ask "No Bloom's Taxonomy outcomes in course description. Use default distribution?"

Step 1.5: Plan Chapter Batches (Parallel Mode)

Divide chapters into batches for parallel processing:

Batch Size Guidelines:

4-8 chapters: 2 agents (2-4 chapters each)
9-15 chapters: 3-4 agents (3-4 chapters each)
16-24 chapters: 4-6 agents (4-5 chapters each)
25+ chapters: 5-6 agents (5-6 chapters each)

Example for 23 chapters:

Agent 1: Chapters 1-4 (Foundations)
Agent 2: Chapters 5-8 (Limits & Continuity)
Agent 3: Chapters 9-12 (Derivative Rules)
Agent 4: Chapters 13-16 (Applications)
Agent 5: Chapters 17-20 (Analysis)
Agent 6: Chapters 21-23 (Integration)

Phase 2: Quiz Generation (Parallel or Sequential)

Parallel Execution

Spawn multiple Task agents simultaneously using the Task tool. Each agent receives:

Shared context (course info, glossary terms, Bloom's targets)
Assigned chapters (specific chapter directories)
Quiz format template (the standard format from this skill)
Output instructions (write quiz.md to each chapter directory)

Agent Prompt Template:

You are generating quizzes for an intelligent textbook. Generate quizzes for
the following chapters.

COURSE CONTEXT:
- Course: [course name]
- Target audience: [audience]
- Reading level: [level]

BLOOM'S TAXONOMY TARGETS:
- Introductory chapters (1-3): 40% Remember, 40% Understand, 15% Apply, 5% Analyze
- Intermediate chapters (4-N): 25% Remember, 30% Understand, 30% Apply, 15% Analyze
- Advanced chapters: 15% Remember, 20% Understand, 25% Apply, 25% Analyze, 10% Evaluate, 5% Create

CHAPTERS TO PROCESS:
[List specific chapter directories with full paths]

FOR EACH CHAPTER:
1. Read the chapter content at the index.md file
2. Identify the key concepts covered in that chapter
3. Generate exactly 10 questions following the format below
4. Ensure answer balance: A (2-3), B (2-3), C (2-3), D (2-3)
5. Write the quiz to docs/chapters/[chapter-dir]/quiz.md

QUIZ FORMAT - Each question MUST follow this exact format:

#### [N]. [Question text ending with ?]

<div class="upper-alpha" markdown>
1. [Option A text]
2. [Option B text]
3. [Option C text]
4. [Option D text]
</div>

??? question "Show Answer"
    The correct answer is **[LETTER]**. [Explanation 50-100 words]

    **Concept Tested:** [Concept Name]

---

QUIZ FILE STRUCTURE:
# Quiz: [Chapter Title]

Test your understanding of [topic] with these review questions.

---

[Questions 1-10 following the format above]

REPORT when done:
- Chapter name
- Number of questions
- Bloom's distribution (R:#, U:#, Ap:#, An:#)
- Answer distribution (A:#, B:#, C:#, D:#)

Launching Parallel Agents:

Use the Task tool with multiple invocations in a SINGLE message to run agents in parallel:

[Call Task tool for Agent 1: Chapters 1-4]
[Call Task tool for Agent 2: Chapters 5-8]
[Call Task tool for Agent 3: Chapters 9-12]
[Call Task tool for Agent 4: Chapters 13-16]
[Call Task tool for Agent 5: Chapters 17-20]
[Call Task tool for Agent 6: Chapters 21-23]

IMPORTANT: All Task tool calls MUST be in a single message to execute in parallel. If sent in separate messages, they will run sequentially.

Sequential Execution

For sequential mode or fewer than 4 chapters, process each chapter one at a time following Steps 2-8 below.

Phase 2 Steps (Per Chapter - used by agents or sequential mode)

Step 2: Determine Target Distribution

Based on chapter type (introductory, intermediate, advanced), set target Bloom's Taxonomy distribution:

Introductory Chapters (typically chapters 1-3):

40% Remember
40% Understand
15% Apply
5% Analyze
0% Evaluate
0% Create

Intermediate Chapters:

25% Remember
30% Understand
30% Apply
15% Analyze
0% Evaluate
0% Create

Advanced Chapters:

15% Remember
20% Understand
25% Apply
25% Analyze
10% Evaluate
5% Create

Determine chapter type by:

Position in textbook (first 3 chapters = introductory)
Concept centrality in learning graph (high centrality = advanced)
Explicit markers in chapter metadata
User specification

Target question count: 8-12 per chapter (default: 10)

Step 3: Identify Concepts to Test

Analyze chapter content and learning graph to prioritize concepts:

Priority 1 (Must Test):

High-centrality concepts in learning graph
Concepts mentioned in chapter title or introduction
Concepts with dedicated sections
Key terms emphasized in bold or glossary links

Priority 2 (Should Test):

Supporting concepts with substantial explanation
Concepts with examples
Prerequisites reviewed in chapter
Concepts from learning objectives

Priority 3 (May Test):

Peripheral concepts mentioned briefly
Related concepts for context
Future topics previewed

Aim for 80%+ coverage of Priority 1 concepts.

Step 4: Generate Questions by Bloom's Level

For each concept selected for testing, generate question at appropriate Bloom's level following target distribution.

IMPORTANT FORMATTING REQUIREMENT:

All questions MUST use the mkdocs-material question admonition format with upper-alpha list styling:

#### 1. What is the primary purpose of a learning graph?

<div class="upper-alpha" markdown>
1. To create visual decorations for textbooks
2. To map prerequisite relationships between concepts
3. To generate random quiz questions
4. To organize files in a directory structure
</div>

??? question "Show Answer"
    The correct answer is **B**. A learning graph is a directed graph that maps prerequisite relationships between concepts, showing which concepts must be learned before others. This ensures proper scaffolding in educational content.

    **Concept Tested:** Learning Graph

    **See:** [Learning Graph Concept](../concepts/learning-graph.md)

Formatting Rules:

Use level-4 header (####) with question number
Write question as complete sentence ending with ?
Use <div class="upper-alpha" markdown> wrapper
Write 4 answer options as numbered list (1, 2, 3, 4)
Use ??? question "Show Answer" admonition
Indent answer content with 4 spaces
Start with "The correct answer is [LETTER]."
Include concept name and link to source
Maintain blank line before and after div

Question Writing Guidelines:

Remember Level:

Ask for definitions from glossary
Test fact recall
Identify terminology
Example: "What is the definition of [concept]?"

Understand Level:

Ask for explanations
Test comprehension of relationships
Compare/contrast concepts
Example: "Which best describes the relationship between [A] and [B]?"

Apply Level:

Present scenarios requiring concept application
Test problem-solving using learned methods
Example: "Given [scenario], which approach would you use?"

Analyze Level:

Ask to identify patterns or causes
Test ability to break down concepts
Example: "What is the underlying reason for [phenomenon]?"

Evaluate Level:

Ask for judgments based on criteria
Test critical thinking
Example: "Which approach would be most effective for [goal]?"

Create Level:

Ask to design solutions
Test synthesis of concepts
Example: "How would you design a [system] that [requirements]?"

Step 5: Write Quality Distractors

For each incorrect answer option (distractors), ensure:

Plausibility:

Sounds reasonable to someone who hasn't learned the material
Uses related terminology
Avoids obviously wrong answers
Similar length to correct answer

Educational Value:

Addresses common misconceptions
Tests understanding of related concepts
Discriminates between levels of knowledge
Not trick questions or word games

Common Distractor Patterns:

Partial truth (correct in different context)
Reversal (opposite of correct answer)
Similar terminology (related but distinct concept)
Common error (typical student mistake)

Avoid:

"All of the above" or "None of the above"
Jokes or nonsensical options
Grammatically inconsistent options
Answers that overlap or both could be correct

Step 6: Write Explanations

For each question, write explanation that:

Confirms Correct Answer:

State clearly: "The correct answer is [LETTER]."
Explain why this answer is correct
Reference chapter content or concept definition
Target: 50-100 words

Teaches (Optional but Recommended):

Briefly explain why distractors are incorrect
Clarify common misconceptions
Provide additional context
Link to chapter section for more detail

Example Explanation:

The correct answer is **B**. A learning graph is a directed graph that maps
prerequisite relationships between concepts. Option A is incorrect because
learning graphs serve a structural purpose, not decorative. Option C is
incorrect because quiz generation is not the primary purpose. Option D
confuses learning graphs with file systems.

**Concept Tested:** Learning Graph

**See:** [Learning Graph Concept](../concepts/learning-graph.md#definition)

Step 7: Ensure Answer Balance

Check that correct answers are distributed evenly across A, B, C, D:

Target Distribution:

A: 25% (±5%)
B: 25% (±5%)
C: 25% (±5%)
D: 25% (±5%)

Avoid Patterns:

All C's in a row
Alternating A-B-A-B
Predictable sequences
Position bias (first/last always correct)

Randomization Strategy:

Generate random sequence before writing quiz
Shuffle for each question
Verify distribution after completion
Adjust if imbalanced

Step 8: Create Quiz File

Generate quiz file with proper structure:

Separate Quiz File (docs/chapters/[chapter-name]/quiz.md):

# Quiz: [Chapter Name]

Test your understanding of [chapter topic] with these questions.

---

#### 1. [Question text]?

<div class="upper-alpha" markdown>
1. [Option 1]
2. [Option 2]
3. [Option 3]
4. [Option 4]
</div>

??? question "Show Answer"
    The correct answer is **[LETTER]**. [Explanation]

    **Concept Tested:** [Concept Name]

---

#### 2. [Question text]?

[Continue for all questions...]

Formatting Requirements:

Use horizontal rules (---) between questions
Number questions sequentially (1, 2, 3...)
Maintain consistent spacing
Ensure all markdown renders correctly

Phase 3: Aggregation (Sequential, after parallel agents complete)

After all parallel agents complete, aggregate results.

Step 9: Collect Agent Results

Wait for all Task agents to complete. Collect from each:

List of quiz files created
Per-chapter statistics (questions, Bloom's distribution, answer balance)
Any errors or issues encountered

Step 10: Generate Metadata Files (Optional)

Create docs/learning-graph/quizzes/[chapter-name]-quiz-metadata.json for each chapter:

{
  "chapter": "Chapter Name",
  "chapter_file": "docs/chapters/chapter-name/index.md",
  "quiz_file": "docs/chapters/chapter-name/quiz.md",
  "generated_date": "YYYY-MM-DD",
  "total_questions": 10,
  "content_readiness_score": 85,
  "overall_quality_score": 78,
  "questions": [
    {
      "id": "ch1-q001",
      "number": 1,
      "question_text": "What is the primary purpose of a learning graph?",
      "correct_answer": "B",
      "bloom_level": "Understand",
      "difficulty": "medium",
      "concept_tested": "Learning Graph",
      "source_link": "../concepts/learning-graph.md",
      "distractor_quality": 0.85,
      "explanation_word_count": 67
    }
  ],
  "answer_distribution": {
    "A": 2,
    "B": 3,
    "C": 3,
    "D": 2
  },
  "bloom_distribution": {
    "Remember": 2,
    "Understand": 4,
    "Apply": 3,
    "Analyze": 1,
    "Evaluate": 0,
    "Create": 0
  },
  "concept_coverage": {
    "total_concepts": 12,
    "tested_concepts": 10,
    "coverage_percentage": 83
  }
}

Step 11: Generate Quiz Bank (Aggregate)

Create or update docs/learning-graph/quiz-bank.json with all questions:

{
  "textbook_title": "Building Intelligent Textbooks",
  "generated_date": "YYYY-MM-DD",
  "total_chapters": 20,
  "total_questions": 187,
  "questions": [
    {
      "id": "ch1-q001",
      "chapter": "Introduction to Learning Graphs",
      "question_text": "What is the primary purpose of a learning graph?",
      "options": {
        "A": "To create visual decorations for textbooks",
        "B": "To map prerequisite relationships between concepts",
        "C": "To generate random quiz questions",
        "D": "To organize files in a directory structure"
      },
      "correct_answer": "B",
      "explanation": "A learning graph is a directed graph...",
      "bloom_level": "Understand",
      "difficulty": "medium",
      "concept": "Learning Graph",
      "chapter_file": "docs/concepts/learning-graph.md",
      "source_section": "#definition",
      "tags": ["graph", "prerequisites", "scaffolding"]
    }
  ]
}

Use Cases for Quiz Bank:

LMS export (Moodle, Canvas, Blackboard XML)
Quiz randomization (select subset)
Alternative quiz versions
Chatbot integration (practice questions)
Study app integration

Step 12: Generate Quality Report

Create docs/learning-graph/quiz-generation-report.md:

# Quiz Generation Quality Report

Generated: YYYY-MM-DD
Execution Mode: Parallel (6 agents)
Wall-clock Time: X minutes Y seconds

## Overall Statistics

- **Total Chapters:** 20
- **Total Questions:** 187
- **Avg Questions per Chapter:** 9.4
- **Overall Quality Score:** 76/100

## Execution Summary (Parallel Mode)

| Agent | Chapters | Questions | Time |
|-------|----------|-----------|------|
| Agent 1 | 1-4 | 40 | 45s |
| Agent 2 | 5-8 | 40 | 52s |
| Agent 3 | 9-12 | 40 | 48s |
| Agent 4 | 13-16 | 40 | 51s |
| Agent 5 | 17-20 | 40 | 47s |
| Agent 6 | 21-23 | 27 | 38s |

## Per-Chapter Summary

| Chapter | Questions | Quality Score | Bloom's Score | Coverage |
|---------|-----------|---------------|---------------|----------|
| Ch 1: Introduction | 10 | 82/100 | 24/25 | 83% |
| Ch 2: Learning Graphs | 12 | 78/100 | 22/25 | 90% |
| ... | ... | ... | ... | ... |

## Bloom's Taxonomy Distribution (Overall)

| Level | Actual | Target | Deviation |
|-------|--------|--------|-----------|
| Remember | 22% | 25% | -3% ✓ |
| Understand | 28% | 30% | -2% ✓ |
| Apply | 27% | 25% | +2% ✓ |
| Analyze | 18% | 15% | +3% ✓ |
| Evaluate | 4% | 4% | 0% ✓ |
| Create | 1% | 1% | 0% ✓ |

**Bloom's Distribution Score:** 24/25 (excellent)

## Answer Balance (Overall)

- A: 24% (45/187)
- B: 26% (49/187)
- C: 25% (47/187)
- D: 25% (46/187)

**Answer Balance Score:** 15/15 (perfect distribution)

## Recommendations

[Include recommendations based on aggregated data]

Step 13: Validate Quality

Perform comprehensive validation across all generated quizzes:

1. No Ambiguity:

Each question has exactly one defensible correct answer
Question stem is clear and complete
No grammatical errors

2. Distractor Quality:

All wrong answers are plausible
Distractors test understanding, not just guessing
Similar length and grammatical structure
No overlapping answers

3. Grammar & Clarity:

Professional writing throughout
Consistent verb tense
Proper punctuation
No typos

4. Answer Balance:

Correct answers distributed across A, B, C, D
Within 20-30% per option (target: 25%)
No predictable patterns

5. Bloom's Distribution:

Matches target for chapter type
Within ±15% acceptable
Progressive difficulty through quiz

6. Concept Coverage:

75%+ of major concepts tested
Important concepts have multiple questions
No over-testing trivial concepts

7. No Duplicates:

Unique questions across all quizzes
No near-duplicates (>80% similar)

8. Explanation Quality:

All questions have explanations
Explanations teach, not just confirm
50-100 words target
Reference chapter sections

9. Link Validation:

All source links point to existing content
Use section anchors where appropriate
Links render correctly
Do not place links in quiz.md files that do not work
Do not use link labels to sections that do not exist

10. Bias Check:

No cultural bias
No gender bias
No assumptions about background
Accessible language

Success Criteria:

Overall quality score > 70/100
8-12 questions per chapter
Bloom's distribution within ±15% of target
75%+ concept coverage
Answer balance within 20-30% per option
100% questions have explanations
No duplicate questions
All links valid

Step 14: Update Site Navigation

Update mkdocs.yml to include quizzes in each chapter directory:

nav:
  ...
  - Chapters:
    - Overview: chapters/index.md
    - 1. Introduction to AI and Intelligent Textbooks:
      - Content: chapters/01-intro-ai-intelligent-textbooks/index.md
      - Quiz: chapters/01-intro-ai-intelligent-textbooks/quiz.md
    - 2. Getting Started with Claude and Skills:
      - Content: chapters/02-getting-started-claude-skills/index.md
      - Quiz: chapters/02-getting-started-claude-skills/quiz.md
    - 3. Course Design and Educational Theory:
      - Content: chapters/03-course-design-educational-theory/index.md
      - Quiz: chapters/03-course-design-educational-theory/quiz.md

Note that the string "Chapter" should not be placed in the main chapter content label that points to the index.md file.

Also update mkdocs.yml to include quiz quality reports:

nav:
  ...
  Learning Graph:
    ...
    Quiz Generation Report: learning-graph/quiz-generation-report.md

Step 15: Capture End Time and Write Session Log

Capture the end time:

date "+%Y-%m-%d %H:%M:%S"

Export the session information to logs/quiz-generator-YYYY-MM-DD.md:

# Quiz Generator Session Log

**Skill Version:** 0.3
**Date:** YYYY-MM-DD
**Execution Mode:** Parallel (6 agents)

## Timing

| Metric | Value |
|--------|-------|
| Start Time | YYYY-MM-DD HH:MM:SS |
| End Time | YYYY-MM-DD HH:MM:SS |
| Elapsed Time | X minutes Y seconds |

## Token Usage

| Phase | Estimated Tokens |
|-------|------------------|
| Setup (shared context) | ~15,000 |
| Agent 1 (Ch 1-4) | ~25,000 |
| Agent 2 (Ch 5-8) | ~25,000 |
| ... | ... |
| Aggregation | ~5,000 |
| **Total** | ~160,000 |

## Results

- Total chapters: N
- Total questions: N × 10
- Quality score: XX/100
- All quizzes written successfully: Yes/No

## Files Created

[List all quiz.md files and report files]

Step 16: Notify User

Notify the user:

"Quiz Generator v0.3 complete!

Mode: Parallel (6 agents)
Elapsed time: X minutes Y seconds
Chapters processed: 23
Questions generated: 230
Quality score: 82/100

The site navigation in mkdocs.yml has been updated to include Content/Quiz links for each chapter and the quiz generation report in the learning-graph section.

Session logged to logs/quiz-generator-YYYY-MM-DD.md"

Question Format Reference

Complete Example with All Elements

#### 3. Given a course with 50 concepts, what is the most important factor in organizing the learning graph?

<div class="upper-alpha" markdown>
1. Alphabetical order of concept names
2. Prerequisite relationships between concepts
3. The length of concept definitions
4. The visual appearance of the graph diagram
</div>

??? question "Show Answer"
    The correct answer is **B**. Prerequisite relationships are the most important factor because they determine the order in which concepts must be learned. A learning graph maps these dependencies to ensure students learn foundational concepts before advanced ones. Alphabetical order (A) and visual appearance (D) are organizational preferences, not educational requirements. Definition length (C) does not affect concept sequencing.

    **Concept Tested:** Learning Graph Structure

    **See:** [Learning Graph](../concepts/learning-graph.md#prerequisites)

Formatting Checklist

[ ] Level-4 header with question number
[ ] Complete sentence ending with ?
[ ] <div class="upper-alpha" markdown> wrapper
[ ] Numbered list (1, 2, 3, 4) for options
[ ] Closing </div> tag
[ ] ??? question "Show Answer" admonition
[ ] 4-space indentation in answer block
[ ] "The correct answer is [LETTER]." statement
[ ] Explanation (50-100 words)
[ ] Concept Tested: label
[ ] See: link with proper path
[ ] Blank lines before and after div

Common Pitfalls to Avoid

Format Errors:

❌ Forgetting <div class="upper-alpha" markdown> wrapper
❌ Using letters (A, B, C, D) instead of numbers in list
❌ Incorrect indentation in answer block
❌ Missing closing </div> tag

Question Quality:

❌ Ambiguous questions with multiple correct answers
❌ "All of the above" or "None of the above" options
❌ Trick questions or word games
❌ Questions testing trivial facts

Distractor Quality:

❌ Obviously wrong answers
❌ Joke options or nonsense
❌ Distractors much longer/shorter than correct answer
❌ Options that overlap or contradict

Explanation Quality:

❌ Just restating the question
❌ No teaching value
❌ Missing or broken links
❌ Too brief (< 30 words) or too long (> 150 words)

Parallel Execution:

❌ Sending Task calls in separate messages (runs sequentially)
❌ Not waiting for all agents before aggregation
❌ Forgetting to aggregate statistics from all agents

Output Files Summary

Required (Per Chapter):

Quiz markdown file: docs/chapters/[chapter-name]/quiz.md

Recommended (Aggregate): 2. docs/learning-graph/quiz-generation-report.md - Quality metrics 3. logs/quiz-generator-YYYY-MM-DD.md - Session log with timing

Optional: 4. docs/learning-graph/quiz-bank.json - All questions database 5. docs/learning-graph/quizzes/[chapter-name]-quiz-metadata.json - Per-chapter metadata 6. Navigation updates to mkdocs.yml

Example Session

Parallel Mode (Default)

User: "Generate quizzes for all chapters"

Claude (using this skill):

Captures start time
Notifies: "Quiz Generator Skill v0.3 running in parallel mode."
Reads shared context (course description, learning graph, glossary)
Scans chapter directories, finds 23 chapters
Assesses content readiness (all chapters 2000+ words)
Plans batches: 6 agents, ~4 chapters each
Spawns 6 Task agents in a SINGLE message (parallel execution)
Waits for all agents to complete
Aggregates results from all agents
Generates quality report (score: 82/100)
Updates mkdocs.yml navigation
Captures end time
Writes session log
Reports: "Quiz Generator v0.3 complete! Mode: Parallel. Time: 2m 45s. Questions: 230. Quality: 82/100."

Sequential Mode

User: "Generate a quiz for Chapter 3 only"

Claude (using this skill):

Assesses Chapter 3 content readiness (score: 82/100)
Determines chapter type: intermediate
Sets target distribution: 25% Remember, 30% Understand, 30% Apply, 15% Analyze
Identifies 12 concepts to test (10 priority 1, 2 priority 2)
Generates 10 questions using question admonition format
Creates quality distractors
Ensures answer balance (A: 2, B: 3, C: 3, D: 2)
Writes explanations without links unless verified
Writes quiz to docs/chapters/03-chapter-name/quiz.md
Reports: "Created 10-question quiz for Chapter 3. Quality score: 78/100."

Agent Skills: Quiz Generator for Intelligent Textbooks

Install this agent skill to your local

Skill Files