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
Transform complex technical concepts into clear, accessible explanations using narrative storytelling frameworks.
Before crafting your explanation:
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.
Use one of three narrative structures:
This is the primary go-to structure.
Use for business contexts and practical applications.
Replace technical jargon with clear, direct explanations of the core concept.
Example:
Plain English means explaining the concept directly without jargon—not just using analogies.
Always provide at least one concrete example with specific details, numbers, or real instances.
Example:
Analogies map the unfamiliar to the familiar, but use them sparingly and strategically—not as the primary explanation method.
When to use:
Avoid over-relying on analogies. Start with direct, plain English explanations.
Attention and mental effort are finite. Be economical with your audience's cognitive resources.
Numbers help navigate information and make it more digestible (e.g., "3 ways to fine-tune", "System 1 and System 2").
Adjust technical depth, terminology, and focus based on who you're talking to.
C-Suite / Business Leaders:
BI Analysts / Technical Adjacent:
Data Scientists / Technical Peers:
If audience level is unclear: Assume the lowest level of understanding and explain accordingly. Don't ask the user to clarify—just start with fundamentals. You can always go deeper if they ask for more detail.
research_methodology.md first