quiz-generator_skill

Overview

This skill generates interactive multiple-choice quizzes for each chapter of an intelligent textbook, aligning each question with specific concepts from the learning graph and distributing items across Bloom's Taxonomy levels. It produces mkdocs-material formatted quizzes, quality explanations, distractor analysis, and machine-readable metadata for integration with LMS or study tools. Use it after chapter content and the learning graph are available.

How this skill works

The skill analyzes chapter markdown and the learning graph to prioritize concepts and compute a content readiness score. It selects target Bloom distributions based on chapter type, generates 8–12 questions with four balanced options (A–D), writes pedagogically sound distractors, and produces explanations and links back to source content. Outputs include a quiz markdown file, a per-chapter metadata JSON, and aggregated quiz-bank and quality reports.

When to use it

• After chapter content is complete (recommended 1000+ words) and a learning graph exists
• When creating or updating quizzes for new or revised chapters
• To build or refresh a centralized quiz bank for LMS export
• When preparing chapter-level formative assessments or chatbot practice question sets
• For incremental generation (one chapter) or batch generation (whole textbook)

Best practices

• Run content readiness checks first and address low-scoring chapters before generating full quizzes
• Ensure glossary entries and learning-graph mappings exist for high-quality Remember and Understand items
• Set chapter type (intro/intermediate/advanced) or verify position in the book to get appropriate Bloom distributions
• Aim for 8–12 questions per chapter; default is 10 to balance coverage and depth
• Review distractor plausibility and answer-letter balance after generation; the tool enforces even distribution but manual review is recommended

Example use cases

• Auto-generate chapter quizzes appended to each markdown file for student review
• Produce standalone quiz files per chapter and metadata for LMS import or analytics
• Create a centralized quiz bank JSON for randomized study sessions or chatbot-driven tutoring
• Generate quality reports showing Bloom distribution, answer balance, and concept coverage for curriculum audits
• Iteratively update quizzes following content edits or changes in the learning graph