teach-me

name

teach-me

description

Delivers structured, paced VergeOS training modules (agent, fundamentals, vms, networking) grounded in official docs, as preparation before /quiz-me. Use when someone wants to learn or study a VergeOS topic. Applies to "teach me VergeOS networking", "I want to learn about tenants", "train me on VM management", "help me study fundamentals", "onboard me to the support agent". Returns topic-by-topic lessons with key points, support context, quick references, and cited sources.

VergeOS Training: $ARGUMENTS

This skill provides structured learning content for VergeOS support engineers. Use this to learn concepts before testing your knowledge with /quiz-me.

Step 1: Module Selection

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

Module	Description
agent	How to use this support agent, skills, and workflows
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 learn?"
• Options: agent, fundamentals, vms, networking

Step 2: Fetch Current Documentation

Use VergeOS Docs MCP to gather authoritative content for the selected module. For the agent module, read local repository files instead.

For agent (read local files, not VergeOS Docs):

• Read: CLAUDE.md (main agent configuration and guidelines)
• Read: .claude/skills/*/SKILL.md (all available skills)
• Read: agents/*/README.md or agents/*/*.md (specialist agent documentation)
• Read: templates/ directory contents (response templates)

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"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS multi-tier"

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"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS VM snapshots"

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"
• Query: mcp__vergeos-docs__searchDocumentation with "VergeOS network troubleshooting"

Step 3: Present Learning Content

For each topic in the module, provide structured educational content:

agent - 5 topics:

1. Agent overview and purpose
2. Available skills and when to use them
3. Using VergeOS Docs MCP effectively
4. Specialist agents for domain-specific tasks
5. Best practices and workflow tips

fundamentals - 5 topics:

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

vms - 5 topics:

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 - 5 topics:

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

Step 4: Content Format for Each Topic

Present each topic using this structure:

---

## Topic [N] of 5: [Topic Name]

### What It Is
[1-2 sentence definition of the concept]

### Key Points
- [Important fact 1 from documentation]
- [Important fact 2 from documentation]
- [Important fact 3 from documentation]
- [Important fact 4 from documentation]

### How It Works
[Brief technical explanation - 2-3 sentences]

### In Support Context
[When you'll encounter this, common customer questions]

### Quick Reference
- **UI Path** or **Command**: [Where to find in UI, or skill/command to use]
- **Related Concepts**: [Connected features to understand]

**Source**: [Documentation URL or repository file path]

---

Step 5: Interactive Pacing

After presenting each topic:

1. Pause for comprehension - Use AskUserQuestion:

   • Header: "Continue?"
   • Question: "Ready for the next topic, or would you like me to expand on anything?"
   • Options:
     • "Next topic" (default)
     • "Expand on this"
     • "Skip to summary"

2. If "Expand on this": Provide additional detail from VergeOS Docs documentation, including:

   • Step-by-step procedures
   • Common pitfalls
   • Real support scenarios

3. If "Skip to summary": Jump to Step 6

Step 6: Module Summary

After all 5 topics, provide:

1. Key Takeaways: 5 bullet points summarizing the most critical information

2. Common Support Scenarios: 3 realistic situations where this knowledge applies

3. Test Your Knowledge (for VergeOS modules only):

   Ready to test what you've learned? Run `/quiz-me [module]` to take a 5-question quiz.
   

   Note: The agent module does not have a quiz - practice by using the skills!

4. Documentation References: List all documentation URLs used

5. Suggested Next Module:

   • After agent: "Now learn VergeOS concepts with /teach-me fundamentals"
   • After fundamentals: "Continue your learning with /teach-me vms"
   • After vms: "Continue your learning with /teach-me networking"
   • After networking: "You've completed the core training modules!"

Important Guidelines

• Base all content on authoritative sources - Use VergeOS Docs for VergeOS modules, local repository files for the agent module. Never invent features or behaviors
• Keep explanations practical - Focus on what support engineers need to know
• Include specific UI paths and commands where available
• Highlight common customer issues related to each topic
• Always cite documentation sources with URLs
• Connect concepts to support scenarios and ticket resolution