Token导航 LogoToken导航

Agent Skill · AI 工具

quiz-generator(测验生成器)

quiz-generator 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

quiz-generator 是AI 工具类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为权限未标注;许可证为 MIT,第三方扫描已通过,按安装量在AI 工具类的 2,536 个 Skill 里排第 843。

总安装 1,885周安装 77GitHub Stars 65下载 610核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
MIT

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:quiz-generator(测验生成器)
来源仓库:https://github.com/dmccreary/claude-skills
仓库路径:skills/quiz-generator
安装命令:
npx skills add https://github.com/dmccreary/claude-skills --skill quiz-generator
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异;本站展示可直接复制的安装命令,安装前请核对来源页面。

skills.shnpx skills
npx skills add https://github.com/dmccreary/claude-skills --skill quiz-generator

这个 Skill 是做什么的

AI 工具类 Skill 用来扩展助手本身的能力,例如接模型、接检索、接外部服务。

quiz-generator 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。

安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。适用于 AI 工具类任务,支持多宿主环境集成。适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/quiz-generator

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/dmccreary/claude-skills --skill quiz-generator;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    权限没有明确标注,第一次使用时只给一个无关紧要的任务,观察它到底读了哪些文件和网络。

常见问题

6 条

quiz-generator 怎么安装?

在终端执行 npx skills add https://github.com/dmccreary/claude-skills --skill quiz-generator。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

quiz-generator 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

quiz-generator 需要什么权限?

权限级别没有明确标注。第一次使用时建议只给无关紧要的任务,观察它实际读写了哪些内容。

quiz-generator 是免费的吗?

来源标注的许可证是 MIT。本站不代收任何费用,也不托管安装包;能否商用、要不要署名,以许可证原文为准。

quiz-generator 用的人多吗?

公开数据是累计安装 1,885 次,近一周安装 77 次,下载 610 次,GitHub 65 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

quiz-generator 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 3 个目录同时收录,说明这个 Skill 流传比较广。
  • 许可证明确为 MIT,商用和分发边界好判断。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理AI 工具类任务、又不想每次都手写提示词的人。
  • 需要许可证清楚、并且有第三方扫描结果的团队项目。

不太适合

  • 需要厂商级技术支持和 SLA 的生产系统。

AI 工具类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
executing-plans

执行计划 · Codex、Claude

1,515,336173,110只读MIT通过
verification-before-completion

完成前的验证 · Codex、Claude

1,319,472173,121权限未标注MIT通过
subagent-driven-development

子 Agent 驱动开发 · Codex、Claude

1,312,416173,138只读MIT通过
copy-editing

复制编辑 · Codex、Claude

1,209,57625,632只读MIT通过
paywall-upgrade-cro

付费专区升级 cro · Codex、Claude

1,030,17625,617只读MIT通过
quiz-generator

测验生成器 · 本页

1,88565权限未标注MIT通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Quiz Generator for Intelligent Textbooks

Version: 0.4

Overview

  1. For each markdown chapter, generate interactive multiple-choice quizzes for textbook chapters with quality distractor analysis.
  2. Generate quality reports in markdown format.
  3. Update mkdocs.yml navigation to include quizzes and reports.

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:

  1. Chapter content has been generated or written (1000+ words per chapter)
  2. Learning graph exists with concept dependencies
  3. 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

Token Efficiency: Serial Execution Only

!!! warning "NEVER Use Parallel Agents Unless the User Explicitly Requests It" Always use a single serial agent for quiz generation. This is a hard requirement, not a suggestion. Do not offer parallel execution as an option.

Each spawned agent incurs ~12,000 tokens of startup overhead (system prompt, tool schemas, project context). Parallel execution multiplies this overhead with zero quality benefit. Measured data from a 17-chapter quiz generation:

ApproachSystem OverheadTotal TokensWaste
Serial (1 agent)~12,000~310,000—
Parallel (4 agents)~48,000~358,000+48,000 (13%)

Additional problems with parallel execution observed in production:

  1. Inconsistent behavior: Agents independently choose different strategies, causing 5x variation in tool calls (8 vs 39) for the same workload
  2. Conflicting file edits: Multiple agents modifying mkdocs.yml simultaneously causes inconsistencies requiring manual repair
  3. No shared learning: Each agent starts from scratch with no accumulated context from earlier chapters

The skill supports two modes:

  • Serial mode (default, always): One agent processes all chapters sequentially
  • Single chapter mode: Generate quiz for one specific chapter

Workflow

Phase 1: Setup (Sequential)

This phase runs once before quiz generation, reading shared context.

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.4 running in serial mode."

Step 1.3: Read Shared Context

Read and cache these files for all agents:

  1. Course Description (docs/course-description.md)

- Extract target audience and reading level - Note Bloom's Taxonomy learning outcomes

  1. Learning Graph (docs/learning-graph/learning-graph.csv or similar)

- Load concept list with dependencies - Calculate concept centrality for prioritization

  1. Glossary (docs/glossary.md)

- Load term definitions for terminology questions - Note which concepts have glossary entries

  1. 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?"

Phase 2: Quiz Generation (Serial)

Launch ONE agent that processes all chapters sequentially. The agent reads each chapter, generates 10 questions, and writes the quiz file before moving to the next chapter. This pays the ~12K system prompt overhead only once.

Agent Prompt Template:

You are generating quizzes for an intelligent textbook. Generate quizzes for
ALL of the following chapters, processing them one at a time.

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 ALL 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:#)

Phase 2 Steps (Per Chapter)

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:

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

After the serial agent completes, collect its results:

  • 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: Serial (1 agent)
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

## 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.4
**Date:** YYYY-MM-DD
**Execution Mode:** Serial (1 agent)

## 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 |
| Serial agent (all chapters) | ~295,000 |
| Aggregation + nav update | ~5,000 |
| **Total** | ~315,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.4 complete!

  • Mode: Serial (1 agent)
  • 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)

Token Efficiency:

  • ❌ Using parallel agents (wastes ~12K tokens per extra agent in system prompt overhead)
  • ❌ Spawning multiple agents when a single serial agent would produce the same output
  • ❌ Offering parallel execution as an option without the user explicitly requesting it

Output Files Summary

Required (Per Chapter):

  1. 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

All Chapters (Default Serial Mode)

User: "Generate quizzes for all chapters"

Claude (using this skill):

  1. Captures start time
  2. Notifies: "Quiz Generator Skill v0.4 running in serial mode."
  3. Reads shared context (course description, learning graph, glossary)
  4. Scans chapter directories, finds 23 chapters
  5. Assesses content readiness (all chapters 2000+ words)
  6. Launches ONE serial agent that processes all 23 chapters sequentially
  7. Agent reads each chapter, generates 10 questions, writes quiz.md, then moves to next
  8. Collects results from the single agent
  9. Generates quality report (score: 82/100)
  10. Updates mkdocs.yml navigation
  11. Captures end time
  12. Writes session log
  13. Reports: "Quiz Generator v0.4 complete! Mode: Serial. Time: 33m. Questions: 230. Quality: 82/100."

Single Chapter Mode

User: "Generate a quiz for Chapter 3 only"

Claude (using this skill):

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

平台分布

Codex

31.52%
按下载量换算192

windsurf

23.31%
按下载量换算142

Claude Code

18.97%
按下载量换算116

OpenCode

11.07%
按下载量换算68

Gemini CLI

8.42%
按下载量换算51

Antigravity

3.79%
按下载量换算23

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

权限未标注

当前来源未能明确判断权限范围,默认进入异常复核队列。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。

继续浏览同类 Skills