quiz-me

name

quiz-me

description

Runs an interactive 5-question VergeOS knowledge quiz (fundamentals, vms, networking) with scored feedback grounded in official docs. Use when someone wants to test or assess their VergeOS knowledge. Applies to "quiz me on VergeOS networking", "test my knowledge of VMs", "give me a VergeOS quiz", "assess my fundamentals", "I want to practice for support". Returns multiple-choice questions, per-answer feedback with doc references, and a final score with study recommendations.

VergeOS Support Training: $ARGUMENTS

Step 1: Module Selection

Based on the argument "$ARGUMENTS", route to the appropriate training module:

Module	Description
fundamentals	Platform architecture, tenants, nodes, clusters
vms	VM creation, VirtIO, imports, snapshots, migration
networking	VLANs, internal/external networks, firewall, routing

If no argument or invalid argument: Use AskUserQuestion to present available modules:

• Header: "Module"
• Question: "Which training module would you like to start?"
• Options: fundamentals, vms, networking

Step 2: Fetch Current Documentation

Before generating questions, use VergeOS Docs MCP to ensure accuracy:

For fundamentals:

• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS architecture overview"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS tenant"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS cluster nodes"

For vms:

• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS create virtual machine"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS VirtIO drivers"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS import VM"

For networking:

• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS network configuration"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS VLAN"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS firewall rules"

Step 3: Generate Quiz Questions

Create 5 questions for the selected module with this mix:

• 2 conceptual questions (definitions, architecture)
• 2 procedural questions (how to perform tasks)
• 1 scenario question (troubleshooting situation)

Question topics by module:

fundamentals:

1. VergeOS architecture and hyperconvergence
2. Tenant concepts and isolation
3. Node roles (controller vs compute)
4. Cluster configuration
5. Multi-tier environments

vms:

1. VM creation process
2. VirtIO drivers and guest agent
3. VM import methods (P2V, V2V, VMware)
4. Snapshots and cloning
5. VM migration and HA

networking:

1. Network types (internal, external, VLAN)
2. VXLAN transport
3. VLAN configuration
4. Firewall rules and NAT
5. Network troubleshooting

Step 4: Deliver Questions

For each of the 5 questions:

1. Present the question in this format:

   **Question [N] of 5** - [Topic Area]
   
   [Question text based on VergeOS Docs documentation]
   
   A) [Option - one correct]
   B) [Option - plausible but wrong]
   C) [Option - plausible but wrong]
   D) [Option - plausible but wrong]
   

2. Use AskUserQuestion with:

   • Header: "Q[N]"
   • Question: The full question text
   • Options: A, B, C, D with their text
   • multiSelect: false

3. After user answers, provide feedback:

   • If correct: Confirm and explain why it's correct
   • If incorrect: Explain the correct answer
   • Always include: Documentation URL from VergeOS Docs results

   Format:

   [Correct/Incorrect] - [Brief explanation]
   
   **Reference**: [Link to VergeOS documentation]
   

4. Track the score (count correct answers)

Step 5: Session Summary

After all 5 questions, provide:

1. Score: "You scored X out of 5"

2. Assessment:

   • 5/5: "Excellent! You have strong knowledge of VergeOS [module]."
   • 4/5: "Great job! Review the topic you missed for full mastery."
   • 3/5: "Good foundation. Consider reviewing the missed topics."
   • 0-2/5: "I recommend reviewing the [module] documentation before handling tickets in this area."

3. Resources for missed topics: List documentation URLs for any questions answered incorrectly

4. Suggested next module:

   • After fundamentals: "Ready to continue? Try /quiz-me vms next."
   • After vms: "Ready to continue? Try /quiz-me networking next."
   • After networking: "You've completed the core modules!"

Important Guidelines

• Generate varied questions each session (don't repeat exact wording)
• Base questions on current VergeOS Docs documentation for accuracy
• Include specific commands or settings where relevant
• Use realistic scenarios for troubleshooting questions
• Keep questions practical and relevant to support work