---
slug: "video-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/lispking/video-skills@main/README.md"
repo: "https://github.com/lispking/video-skills"
source_file: "README.md"
branch: "main"
---
# Manim Video Teacher Skill

A skill package and helper scripts to turn prompts into Manim teaching videos with optional narration, muxing, and cover generation.

## Quick start

1) Create a virtual environment and install deps:

```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

2) Render your Manim scene to a video file (example):

```bash
manim -qh your_scene.py YourScene
```

3) Run the pipeline (TTS + mux + cover):

```bash
python manim-video-teacher/scripts/pipeline.py \
  --video media/videos/your_scene/1080p60/YourScene.mp4 \
  --tts-file examples/narration.txt \
  --cover-title "Quadratic Vertex Form" \
  --cover-subtitle "Learn in 60s" \
  --output output.mp4
```

## Scripts

- `manim-video-teacher/scripts/tts_generate.py`: Generate narration audio with edge-tts.
- `manim-video-teacher/scripts/concat_audio.py`: Concatenate multiple audio segments.
- `manim-video-teacher/scripts/mux_av.py`: Mux audio and video into a single MP4.
- `manim-video-teacher/scripts/make_cover.py`: Generate a simple 16:9 cover image.
- `manim-video-teacher/scripts/pipeline.py`: One-click pipeline for TTS, mux, and cover.

## Requirements

- Python 3.10+
- ffmpeg (installed and on PATH)

## Skill installation

Install the skill by placing the folder under your skills directory:

```bash
./scripts/install_skill.sh --dest /path/to/skills
```

If you are using Codex and have `$CODEX_HOME` set, you can omit `--dest`:

```bash
./scripts/install_skill.sh
```

Reinstall with overwrite:

```bash
./scripts/install_skill.sh --dest /path/to/skills --force
```

Preview the resolved install target:

```bash
./scripts/install_skill.sh --list
```

Install into a local `./skills` folder in the current directory:

```bash
./scripts/install_skill.sh --here
```

If a `./skills` folder already exists, the installer will use it by default.

## Examples

- `examples/narration.txt`: Sample narration text.
- `examples/scene.py`: Minimal Manim scene to render.
- `examples/tts_list.txt`: Example ffmpeg concat list file.

## Demo script

Run an end-to-end demo (venv + deps + render + pipeline):

```bash
./scripts/run_demo.sh
```

Clean generated files:

```bash
./scripts/clean.sh
```

## Skill package

The skill lives in `manim-video-teacher/` with its `SKILL.md` and scripts.

## License

Apache License 2.0. See `LICENSE`.