MathLens

Generate narrated math-teaching videos from image or text problems.

374|15|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/shuyicc/MathLens --skill mathlens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MathLens
Source: https://github.com/shuyicc/MathLens/tree/main
Command: npx skills add https://github.com/shuyicc/MathLens --skill mathlens

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires edge-tts, mutagen, and includes scripts (resource) and references (resource) components.

What problem does it solve?

MathLens enables educators and learners to transform a math problem into a fully narrated, visual teaching video that integrates analysis, visualization, scripting, and rendering.

Core Features & Use Cases

  • End-to-end teaching pipeline: problem analysis → HTML visualization → storyboard generation → TTS audio → validation → scaffolding → Manim code → final render.
  • HTML/SVG visual explanations: automatically generate annotated diagrams that illustrate each reasoning step.
  • Audio-visual synchronization: per-scene synchronized narration with high-level timing data to ensure video aligns with speech.
  • Reproducible workflow: templates, scaffolding, and render controls to reproduce outputs across problems.
  • Use Case: a teacher pastes a geometry problem and instantly receives a complete teaching video ready for classroom or online sharing.

Quick Start

Install dependencies, initialize your MathLens project, and paste a math problem to trigger the full 8-step workflow.

Frequently Asked Questions about MathLens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate narrated math teaching videos from a problem?

To generate narrated math teaching videos, you can input a math problem as text or an image to trigger an automated pipeline. The workflow produces HTML visuals, storyboard scripts, TTS audio, and Manim animations for a complete teaching video output.

Can I use Manim animations with TTS audio for automated math visualization?

Yes, Manim animations can be synchronized with TTS audio. The workflow uses edge-tts to generate narration and applies per-scene timing data to ensure the visual Manim animations align directly with the speech audio.

What's the best way to turn a geometry problem image into a visual explanation video?

The best way to turn a geometry problem image into a video is through an end-to-end pipeline that analyzes the image, generates HTML/SVG annotated diagrams for reasoning steps, and renders a final Manim animation with narration.

Do I need edge-tts and mutagen installed to create math teaching videos?

Yes, you need edge-tts and mutagen installed. Edge-tts generates the narration audio for the storyboard, while mutagen handles audio metadata to achieve per-scene audio-visual synchronization and timing validation.

How does the storyboard generation work for math visualization videos?

Storyboard generation works by analyzing the math problem, creating an HTML visual explanation, and producing a timed narration script. This script scaffolds the Manim code generation and ensures TTS audio aligns with the visual scenes.

Are there limitations when using automated TTS and Manim for math problem videos?

Limitations include dependency on edge-tts for audio generation and Manim for rendering, requiring a reproducible workflow with templates and scaffolding to validate timing and ensure outputs align correctly across different math problems.