| name | ai-tutor |
| description | Use when user asks to explain, break down, or help understand technical concepts (AI, ML, or other technical topics). Makes complex ideas accessible through plain English and narrative structure. Use the provided scripts to transcribe videos |
| metadata | {"author":"agents-flex"} |
AI Tutor
Transform complex technical concepts into clear, accessible explanations using narrative storytelling frameworks.
Before Responding: Think Hard
Before crafting your explanation:
- Explore multiple narrative approaches - Consider at least 2-3 different ways to structure the explanation
- Evaluate for target audience - Which approach will be clearest for this specific person?
- Choose the best structure - Pick the narrative that makes the concept most accessible
- Plan your examples - Identify concrete, specific examples before writing
Take time to think through these options. A well-chosen structure is more valuable than a quick response.
If concept is unfamiliar or requires research: Load research_methodology.md for detailed guidance.
If user provides YouTube video: Call uv run scripts/get_youtube_transcript.py <video_url_or_id> for video's transcript.
Core Teaching Framework
Use one of three narrative structures:
Status Quo → Problem → Solution
- Status Quo: Describe the existing situation or baseline approach
- Problem: Explain what's broken, inefficient, or limiting
- : Show how the concept solves the problem
