Agent skill

Md2video Audio

by sickn33 in sickn33/agentic-awesome-skills

Convert Markdown documents into narrated MP4 videos with synchronized visuals and voice narration.

Apache-2.0Auto-check passedMedia & Creative

Install Md2video Audio

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill md2video-audio -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills md2video-audio --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/md2video-audio .claude/skills/md2video-audio && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
md2video-audio
GitHub stars
47k
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
477 words
Files
1
Skills in repo
1,493
Repo updated
First seen
Licence
Apache-2.0

At a glance

Convert Markdown documents into narrated MP4 videos with synchronized visuals and voice narration.

  • Works in 6 steps: Check Environment → Prepare the Markdown → Generate Presentation Markdown → …
  • Tasks that involve Text to speech and voice
  • SKILL.md covers Overview, When to Use This Skill, How It Works and Examples, plus 4 more sections
  • Calls python

What it does

Md2video Audio is an agent skill from sickn33/agentic-awesome-skills. Convert Markdown documents into narrated MP4 videos with synchronized visuals and voice narration.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Text to speech and voice, Slides and decks and Markdown. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Text to speech and voice
  • Tasks that involve Slides and decks
  • Tasks that involve Markdown

Example prompts

  • “/md2video-audio”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Check Environment
  2. Prepare the Markdown
  3. Generate Presentation Markdown
  4. Generate Narration
  5. Generate Video
  6. Fallback

What it can do on your machine

Read from SKILL.md and the folder at commit 680176d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Md2video Audio loads about 1.1k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 477 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit 680176d, republished under its Apache-2.0 licence (© sickn33). 477 words, ~1,097 tokens.

Download SKILL.mdSave it as .claude/skills/md2video-audio/SKILL.md (or your agent's skills folder).
name
md2video-audio
description
Convert Markdown documents into narrated MP4 videos with synchronized visuals and voice narration.
category
media
risk
safe
source
community
source_repo
70v-Yoyo/md2video-audio-skill
source_type
community
date_added
2026-09-12
author
70v-Yoyo
tags
markdown, video, audio, text-to-speech, marp, presentation
tools
claude, cursor, gemini
license
Apache-2.0

Md2video-audio

Overview

md2video-audio converts a Markdown document into a narrated MP4 video by transforming the source into synchronized presentation visuals and spoken narration.

The workflow preserves the original file and generates separate presentation, narration, and video outputs.

  • source_repo: 70v-Yoyo/md2video-audio-skill
  • source_type: community

When to Use This Skill

  • Use when converting Markdown tutorials, reports, or presentations into narrated videos.
  • Use when creating presentation-style videos.
  • Use when the user asks for Markdown-to-video, narrated slides, or audio-video generation.

How It Works

Step 1: Check Environment

Verify required local dependencies before running the workflow. Do not install, remove, or modify dependencies without user confirmation.

Step 2: Prepare the Markdown

Keep the original file unchanged.

Create a new Markdown file with improved sectioning, formatting, and natural transitions while preserving the original meaning.

Step 3: Generate Presentation Markdown

Convert the prepared document into Marp-compatible slides.

  • Separate slides with ---.
  • Prevent content overflow.
  • Split oversized tables, code blocks, or sections when necessary.
  • Ask the user to choose a Marp style when required.
Step 4: Generate Narration

Create a narration Markdown file aligned one-to-one with the presentation slides.

Remove visual-only characters that should not be spoken and verify that slide separators remain synchronized.

Step 5: Generate Video

Run the provided video-generation script with the presentation and narration files:

python ai-2md2marp2av.py presentation.md narration.md

The script renders Marp slides, generates speech with Edge-TTS, and combines them into an MP4 video.

Ask the user to complete any interactive input required by the script.

Step 6: Fallback

If the primary workflow fails, try the included fallback scripts in order:

python md2marp2av.py

Then:

python md2video.py

Examples

Example 1: Convert a Tutorial
/md2video-audio tutorial.md

Produces presentation Markdown, narration Markdown, and a narrated MP4 video.

Example 2: Convert a Work Report
/md2video-audio project-review.md

Use the generated slides and narration to create a presentation-style report video.

Show full SKILL.md (191 more words)Show less

Best Practices

  • ✅ Preserve the original Markdown file.
  • ✅ Keep presentation and narration slide counts synchronized.
  • ✅ Split slides that exceed safe layout limits.
  • ✅ Confirm before installing dependencies or running interactive actions.
  • ❌ Do not overwrite the source document.
  • ❌ Do not silently install, remove, or modify system dependencies.

Limitations

  • Requires the local runtime and dependencies used by the included scripts.
  • Complex Markdown layouts may require manual adjustment.
  • Edge-TTS availability depends on the local network and runtime environment.
  • Stop and ask for clarification when required files, permissions, or user choices are missing.

Security & Safety Notes

  • Run scripts only in a local or authorized environment.
  • Confirm with the user before installing dependencies or making environment changes.
  • Generated files should be written as new files rather than replacing source content.
  • Do not execute interactive or destructive commands without explicit user confirmation.

Common Pitfalls

  • Problem: Presentation and narration contain different slide counts. Solution: Verify the number of --- separators and realign the narration.
  • Problem: Slide content overflows the Marp layout. Solution: Split the content into smaller logical sections before rendering.
  • Problem: Video generation fails because dependencies are unavailable. Solution: Verify the environment first, then use the fallback scripts if appropriate.

© sickn33, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/md2video-audio of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Md2video Audio next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Md2video Audio compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Md2video Audio this skillsickn33/agentic-awesome-skills47k1 repos~1.1kAutomated safety check: PassApache-2.0
Guided Demosammcj/agentic-coding162—~2.1kAutomated safety check: PassApache-2.0
Epub2podcast Ark Plandracohu2025-cloud/draco-skills-collection227—~1.8kAutomated safety check: PassMIT
Web Video PresentationConardLi/garden-skills13k—~3.5kAutomated safety check: PassMIT
Roadshow Video Generatoranbeime/skill7.7k—~1.4kAutomated safety check: NotesNone
Book Media Generatordmccreary/ibook-skills105—~1.7kAutomated safety check: PassCC-BY-NC-4.0

Similar skills

  • Guided Demo

    sammcj/agentic-coding

    A pattern for adding a self-narrating (typed out) guided walkthrough to any HTML/web application.

    162 GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Epub2podcast Ark Plan

    dracohu2025-cloud/draco-skills-collection

    【Ark Agent Plan 专用版本】EPUB 转双人中文播客视频流水线:使用火山引擎 TTS(与 Seedream/Seedance 共享技术栈),Smart Slide + 双人音频 + 最终 MP4 视频,无需额外 Google/OpenRouter API Key。

    227 GitHub stars~1.8k tokensUpdated 22 days ago
    Media & CreativeAuto-check passed
  • Web Video Presentation

    ConardLi/garden-skills

    Turns an article or spoken script into a click-through, full-screen 16:9 web presentation that looks like a video, with optional synthesized narration.

    13k GitHub stars~3.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Turns a document into a narrated roadshow video through ten staged roles, from document analysis and slide planning to audio, subtitles and final composition.

    7.7k GitHub stars~1.4k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Book Media Generator

    dmccreary/ibook-skills

    Generates media for intelligent textbooks - slide decks and presentations (MARP web decks in docs/slides/ or PowerPoint .pptx lecture downloads), illustrated stories and graphic novels…

    105 GitHub stars~1.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Slides Video

    sugarforever/01coder-agent-skills

    Produce slides-driven narration videos (口播视频) where each slide maps 1:1 to one voiceover section.

    137 GitHub stars~1.5k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Md2video Audio

What does Md2video Audio do?

Convert Markdown documents into narrated MP4 videos with synchronized visuals and voice narration. Md2video Audio is an agent skill from sickn33/agentic-awesome-skills. Convert Markdown documents into narrated MP4 videos with synchronized visuals and voice narration.

When should I use Md2video Audio?

Md2video Audio fits situations like: tasks that involve Text to speech and voice; tasks that involve Slides and decks; tasks that involve Markdown.

How do I install Md2video Audio in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill md2video-audio -a claude-code`. Or copy the skill folder (skills/md2video-audio in sickn33/agentic-awesome-skills) into .claude/skills/md2video-audio in your project. Claude Code loads it when a task matches its description.

How do I install Md2video Audio in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill md2video-audio -a codex`. Or copy the skill folder (skills/md2video-audio in sickn33/agentic-awesome-skills) into .agents/skills/md2video-audio in your project. Codex loads it when a task matches its description.

Can I use Md2video Audio in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill md2video-audio -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/md2video-audio, .gemini/skills/md2video-audio, .github/skills/md2video-audio and .opencode/skills/md2video-audio in your project.

What does Md2video Audio need to run?

Going by SKILL.md and its folder, Md2video Audio needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Md2video Audio access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Md2video Audio safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Md2video Audio use?

Md2video Audio is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Md2video Audio use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Md2video Audio?

Skills that share tags, products or a category with Md2video Audio: Guided Demo (sammcj/agentic-coding, 162 stars), Epub2podcast Ark Plan (dracohu2025-cloud/draco-skills-collection, 227 stars), Web Video Presentation (ConardLi/garden-skills, 13k stars) and Roadshow Video Generator (anbeime/skill, 7.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Md2video Audio?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.