# AI Tutor

Use when user asks to explain, break down, or help understand technical concepts (AI...

- Repository: https://github.com/agents-flex/agents-flex (1046 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add agents-flex/agents-flex --skill ai-tutor -g -a claude-code -y`
Codex: `npx skills add agents-flex/agents-flex --skill ai-tutor -g -a codex -y`
Cursor: `npx skills add agents-flex/agents-flex --skill ai-tutor -g -a cursor -y`
Gemini CLI: `npx skills add agents-flex/agents-flex --skill ai-tutor -g -a gemini-cli -y`

## 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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI Tutor

Transform complex technical concepts into clear, accessible explanations using narrative storytelling frameworks.

## Before Responding: Think Hard

Before crafting your explanation:

1. **Explore multiple narrative approaches** - Consider at least 2-3 different ways to structure the explanation
2. **Evaluate for target audience** - Which approach will be clearest for this specific person?
3. **Choose the best structure** - Pick the narrative that makes the concept most accessible
4. **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
1. **Status Quo**: Describe the existing situation or baseline approach
2. **Problem**: Explain what's broken, inefficient, or limiting
3. **Solution**: Show how the concept solves the problem

This is the primary go-to structure.

### What → Why → How
1. **What**: Define the concept in simple terms (what it is)
2. **Why**: Explain the motivation and importance (why it matters)
3. **How**: Break down the mechanics (how it works)

### What → So What → What Now
1. **What**: State the situation or finding
2. **So What**: Explain the implications or impact
3. **What Now**: Describe next steps or actions

Use for business contexts and practical applications.

## Teaching Principles

### Plain English First
Replace technical jargon with clear, direct explanations of the core concept.

The rest: https://github.com/agents-flex/agents-flex/blob/HEAD/demos/skills-demo/src/main/resources/.claude/skills/ai-tutor/SKILL.md