xhs-video-pipeline

Converts Markdown articles into 1080x1440 GSAP animation videos with BGM and TTS voiceover.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Migeking/video-production-skills --skill xhs-video-pipeline-migeking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xhs-video-pipeline
Source: https://github.com/Migeking/video-production-skills/tree/main/xhs-video-pipeline
Command: npx skills add https://github.com/Migeking/video-production-skills --skill xhs-video-pipeline-migeking

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, ChatTTS, soundfile, edge-tts.

What problem does it solve? Turning a written Xiaohongshu (RED) note into a polished vertical video normally requires manual slide design, screen recording, voiceover recording, and video editing. This Skill automates the entire pipeline from a Markdown article to a finished MP4 with background music and optional AI voiceover. ## Core Features & Use Cases - GSAP Animation Slides: Generates a 1080x1440 (3:4 vertical) animated HTML with 6-10 slides, large typography, dark theme, and GSAP transitions, then captures frames at 10fps via Playwright. - TTS Voiceover: Produces narration with ChatTTS (single-pass for consistent voice) or edge-tts, with guidance on Chinese number formatting to avoid mispronunciation. - FFmpeg Composition: Mixes TTS and BGM (42 CC BY 4.0 Kevin MacLeod tracks) with volume ducking and delay, then encodes H.264/AAC MP4 output. - Use Case: You have a Markdown note about an industrial automation topic. Run the pipeline to get a ~30-second vertical video with narration and background music ready for Xiaohongshu upload. ## Quick Start Make a Xiaohongshu video from my Markdown note using Pipeline A with BGM and TTS voiceover.

Frequently Asked Questions about xhs-video-pipeline

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

FAQPage Schema
How do I turn a Markdown article into a vertical video?

Create a 1080x1440 animated HTML with GSAP slides summarizing the article, capture frames at 10fps with Playwright, then combine frames with BGM and optional TTS using FFmpeg. The pipeline outputs an H.264 MP4 in about 10-15 minutes.

How to add AI voiceover to a video with ChatTTS?

Write one narration line per slide, convert numbers to Chinese full forms, and run a single continuous chat.infer() call with InferCodeParams and manual_seed for consistent voice. Mix the WAV with BGM at 12% volume using FFmpeg amix.

ChatTTS vs edge-tts for Chinese video narration?

ChatTTS runs locally and produces natural prosody but requires the newer load(source='huggingface') API and InferCodeParams object. edge-tts is an online alternative using voices like zh-CN-YunxiNeural with adjustable rate.

Why does ChatTTS read numbers like 80% in English?

ChatTTS pronounces digits and percent signs as English by default. Write numbers as Chinese full forms in the script, such as 百分之八十 instead of 80%, to force correct Chinese pronunciation.

Why do Chinese filenames show as garbled characters in Windows terminal?

Windows console encoding mangles Chinese filenames in FFmpeg output display, though the file itself is fine. Copy the output to an ASCII English alias after composition to avoid confusion.

What are the limitations of the GSAP screenshot video pipeline?

Videos are limited to 6-10 slides at 3.5-4.5 seconds each, and dense content like feature grids or bullet lists is unreadable at video speed. Each slide should carry only one core message with large fonts.