Video-Wrapper-Skills
为访谈视频添加综艺风格视觉特效的 Claude Skill。AI 分析字幕内容生成建议,用户审批后自动渲染。A Claude Skill for adding variety-show-style visual effects to interview videos. The AI analyzes subtitle content to generate suggestions
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/op7418--video-wrapper-skills)HTML
<a href="/listings/op7418--video-wrapper-skills"><img src="/api/listings/op7418--video-wrapper-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Installation
**Method 1: One-Click Install (Recommended)**
npx skills add https://github.com/op7418/Video-Wrapper-Skills
**Method 2: Manual Install**
# Clone to Claude Skills directory cd ~/.claude/skills/ git clone https://github.com/op7418/Video-Wrapper-Skills.git video-wrapper cd video-wrapper # Install dependencies python3 -m venv venv source venv/bin/activate pip install -r requirements.txt playwright install chromium
Usage
**In Claude Code**
/video-wrapper interview.mp4 subtitles.srt
Claude will: 1. 📊 Analyze subtitles, identify key information 2. 💡 Generate effect suggestions (lower thirds, key phrases, term cards, etc.) 3. 📝 Present suggestions in Markdown for review 4. ✅ Auto-render output video after confirmation
**Command Line**
# Direct rendering with config file python src/video_processor.py video.mp4 subs.srt config.json output.mp4 # Specify renderer python src/video_processor.py video.mp4 subs.srt config.json -r browser # Browser python src/video_processor.py video.mp4 subs.srt config.json -r pil # PIL
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 249 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: video-wrapper
- description: 为访谈视频添加综艺特效(花字、卡片、人物条、章节标题等)。支持 4 种视觉主题,先分析字幕内容生成建议供用户审批,再渲染视频。
- argument-hint: <video-file> <subtitle-file> [config.json] [output.mp4]
- user-invocable: true
- allowed-tools: Bash, Read, Write
- context: fork
- agent: general-purpose
- ---
- # 访谈视频处理器
- 基于 Python + Playwright + MoviePy 的视频特效处理工具,使用 HTML/CSS/Anime.js 渲染高质量视觉效果。
- ## 工作流程
- ### 第一步:分析字幕内容
- 当用户提供视频和字幕文件时,先分析字幕内容,生成特效建议:
- 1. 读取字幕文件 (.srt)
- 2. 分析内容,识别:
- - 嘉宾信息(用于人物条)
- - 话题切换点(用于章节标题)
- - 关键词和术语(用于花字)
- - 专业名词(用于名词卡片)
- - 精彩观点(用于金句卡片)
- - 数字数据(用于数据动画)
- - 核心要点(用于要点列表)
- 3. 生成建议列表,展示给用户审核
- ### 第二步:用户审核
- 将建议以 Markdown 格式展示给用户:
- ```
- ## 视觉特效建议
- **主题**: notion
- ### 1. 人物条 (Lower Third)
- - **姓名**: Dario Amodei
- - **职位**: CEO
- - **公司**: Anthropic
- - **出现时间**: 1000ms
- ### 2. 花字高亮 (Fancy Text)
- 1. **通用人工智能** (emphasis)
- 时间: 2630ms - 5500ms
- 原因: 核心概念首次提及
- ...
- ```
- 用户可以:
- - 确认全部建议
- - 修改部分建议
- - 删除不需要的组件
- - 添加新的组件
- ### 第三步:生成配置并渲染
- 根据用户审批后的建议生成 config.json,然后渲染视频。
- ## 可用组件
- | 组件 | 用途 | 配置字段 |
- |------|------|----------|
- | 人物条 (lower_third) | 显示嘉宾信息 | name, role, company, startMs, durationMs |
- | 章节标题 (chapter_title) | 话题切换标题 | number, title, subtitle, startMs, durationMs |
- | 花字 (fancy_text) | 概括当前观点 | text, style, startMs, endMs, position |
- | 名词卡片 (term_card) | 解释术语 | chinese, english, description, firstAppearanceMs |
- | 金句卡片 (quote_callout) | 突出精彩观点 | text, author, startMs, durationMs, position |
- | 数据动画 (animated_stats) | 展示数字 | prefix, number, unit, label, startMs |
- | 要点列表 (bullet_points) | 总结核心要点 | title, points[], startMs, durationMs |
- | 社交媒体条 (social_bar) | 关注引导 | platform, label, handle, startMs, durationMs |
- ### 花字使用规范
- ⚠️ **重要**:花字必须遵循以下规范:
- 1. **必须是短语**:用简短的句子概括说话人当时的观点
- - ✅ 正确:「AI发展是平滑曲线」「智能增长类似摩尔定律」
- - ❌ 错误:「人工智能」「摩尔定律」(这些是单词,应该用名词卡片)
- 2. **与名词卡片互补**:
- - 花字:概括观点(如「智能每年翻倍增长」)
- - 名词卡片:解释术语(如「摩尔定律:集成电路晶体管数量每18-24个月翻一番」)
- 3. **位置在上方**:默认显示在屏幕上方区域(字幕上方),避免遮挡人脸
- ### 社交媒体条使用规范
- - 默认显示时长:8 秒(比其他组件更长,给用户足够时间记住)
- - 通常在视频结尾出现
- - 支持平台:twitter, weibo, youtube
- ## 主题系统
- 支持 4 种视觉主题:
- | 主题 | 风格 | 适用场景 |
- |------|------|----------|
- | `notion` | 温暖知识风 | 教育、知识分享 |
- | `cyberpunk` | 霓虹未来感 | 科技、前沿话题 |
- | `apple` | 极简优雅 | 商务、专业访谈 |
- | `aurora` | 渐变流光 | 创意、艺术内容 |
- ## 配置文件格式
- ```json
- {
- "theme": "notion",
- "lowerThirds": [
- {
- "name": "Dario Amodei",
- "role": "CEO",
- "company": "Anthropic",
- "startMs": 1000,
- "durationMs": 5000
- }
- ],
- "chapterTitles": [
- {
- "number": "Part 1",
- "title": "指数增长的本质",
- "subtitle": "The Nature of Exponential Growth",
- "startMs": 0,
- "durationMs": 4000
- }
- ],
- "keyPhrases": [
- {
- "text": "通用人工智能",
- "style": "emphasis",
- "startMs": 2630,
- "endMs": 5500
- }
- ],
- "termDefinitions": [
- {
- "chinese": "摩尔定律",
- "english": "Moore's Law",
- "description": "集成电路晶体管数量每18-24个月翻一番",
- "firstAppearanceMs": 37550,
- "displayDurationSeconds": 6
- }
- ],
- "quotes": [
- {
- "text": "AI 的发展是一个非常平滑的指数曲线",
- "author": "— Dario Amodei",
- "startMs": 30000,
- "durationMs": 5000
- }
- ],
- "stats": [
- {
- "prefix": "增长率 ",
- "number": 240,
- "unit": "%",
- "label": "计算能力年增长",
- "startMs": 45000,
- "durationMs": 4000
- }
- ],
- "bulletPoints": [
- {
- "title": "核心观点",
- "points": [
- "AI 发展是平滑的指数曲线",
- "类似摩尔定律的智能增长",
- "没有突然的奇点时刻"
- ],
- "startMs": 50000,
- "durationMs": 6000
- }
- ]
- }
- ```
- ## 依赖安装
- ```bash
- # 进入虚拟环境
- cd ~/.claude/skills/video-wrapper
- source venv/bin/activate
- # 安装依赖
- pip install -r requirements.txt
- # 安装 Playwright 浏览器
- playwright install chromium
- ```
- ## 命令行使用
- ```bash
- # 使用浏览器渲染器(推荐)
- python src/video_processor.py video.mp4 subs.srt config.json output.mp4
- # 指定渲染器
- python src/video_processor.py video.mp4 subs.srt config.json -r browser
- python src/video_processor.py video.mp4 subs.srt config.json -r pil
- ```
- ## 技术实现
- - **视觉渲染**: HTML + CSS + Anime.js (通过 Playwright 截图)
- - **视频合成**: MoviePy
- - **动画引擎**: Anime.js (Spring 物理动画)
- - **备用渲染**: Python PIL
- ## 文件结构
- ```
- ~/.claude/skills/video-wrapper/
- ├── src/
- │ ├── video_processor.py # 主处理脚本
- │ ├── browser_renderer.py # Playwright 渲染器
- │ ├── content_analyzer.py # 内容分析器
- │ ├── fancy_text.py # PIL 花字(备用)
- │ └── term_card.py # PIL 卡片(备用)
- ├── templates/
- │ ├── fancy-text.html # 花字模板
- │ ├── term-card.html # 名词卡片模板
- │ ├── lower-third.html # 人物条模板
- │ ├── chapter-title.html # 章节标题模板
- │ ├── quote-callout.html # 金句卡片模板
- │ ├── animated-stats.html # 数据动画模板
- │ └── bullet-points.html # 要点列表模板
- ├── static/
- │ ├── css/
- │ │ ├── effects.css # 基础效果
- │ │ ├── theme-notion.css # Notion 主题
- │ │ ├── theme-cyberpunk.css
- │ │ ├── theme-apple.css
- │ │ └── theme-aurora.css
- │ └── js/
- │ └── anime.min.js # Anime.js
- └── requirements.txt
- ```
- ## 注意事项
- - 视频处理需要较长时间,请耐心等待
- - 确保有足够的磁盘空间存储输出视频
- - Playwright 渲染效果更好,但需要安装 Chromium
- - 如果 Playwright 不可用,会自动回退到 PIL 渲染
README.md · README · 479 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # 🎬 Video Wrapper
- **Add Variety Show Style Visual Effects to Interview/Podcast Videos**
- AI-powered subtitle analysis, automatic effect suggestions, one-click professional visual rendering
- [](https://opensource.org/licenses/MIT)
- [](https://www.python.org/downloads/)
- [](https://claude.ai)
- [Quick Start](#-quick-start) • [Features](#-features) • [Demo](#-demo) • [Use Cases](#-use-cases) • [Architecture](./ARCHITECTURE.md)
- [中文文档](./README_CN.md)
- </div>
- ---
- ## ✨ Features
- <table>
- <tr>
- <td width="50%">
- ### 🎨 8 Visual Components
- - **Key Phrases** - Short phrases highlighting core ideas
- - **Lower Thirds** - Display guest name and title
- - **Chapter Titles** - Topic transition title cards
- - **Term Cards** - Professional terminology explanations
- - **Quote Callouts** - Highlight memorable quotes
- - **Animated Stats** - Dynamic number displays
- - **Bullet Points** - Core takeaways summary
- - **Social Bars** - Follow call-to-action
- </td>
- <td width="50%">
- ### 🎭 4 Visual Themes
- - **Notion** 🟡 - Warm knowledge style
- - **Cyberpunk** 💜 - Neon futuristic
- - **Apple** ⚪ - Minimalist business
- - **Aurora** 🌈 - Gradient flowing
- ### 🤖 Smart Workflow
- 1. 📝 AI analyzes subtitle content
- 2. 💡 Auto-generates effect suggestions
- 3. ✅ User approves configuration
- 4. 🎬 One-click video rendering
- </td>
- </tr>
- </table>
- ### 🛠️ Dual Rendering Engines
- | Engine | Tech Stack | Features |
- |--------|-----------|----------|
- | **Browser** 🌐 | Playwright + HTML/CSS/Anime.js | High quality, complex animations (Recommended) |
- | **PIL** 🎨 | Python PIL | Pure Python, no browser required |
- ---
- ## 🚀 Quick Start
- ### Installation
- **Method 1: One-Click Install (Recommended)**
- ```bash
- npx skills add https://github.com/op7418/Video-Wrapper-Skills
- ```
- **Method 2: Manual Install**
- ```bash
- # Clone to Claude Skills directory
- cd ~/.claude/skills/
- git clone https://github.com/op7418/Video-Wrapper-Skills.git video-wrapper
- cd video-wrapper
- # Install dependencies
- python3 -m venv venv
- source venv/bin/activate
- pip install -r requirements.txt
- playwright install chromium
- ```
- ### Usage
- **In Claude Code**
- ```bash
- /video-wrapper interview.mp4 subtitles.srt
- ```
- Claude will:
- 1. 📊 Analyze subtitles, identify key information
- 2. 💡 Generate effect suggestions (lower thirds, key phrases, term cards, etc.)
- 3. 📝 Present suggestions in Markdown for review
- 4. ✅ Auto-render output video after confirmation
- **Command Line**
- ```bash
- # Direct rendering with config file
- python src/video_processor.py video.mp4 subs.srt config.json output.mp4
- # Specify renderer
- python src/video_processor.py video.mp4 subs.srt config.json -r browser # Browser
- python src/video_processor.py video.mp4 subs.srt config.json -r pil # PIL
- ```
- ---
- ## 🎥 Demo
- > 💡 Visual effects showcase across different themes and components
- ### Theme Comparison
- <table>
- <tr>
- <td align="center" width="25%"><strong>Notion Theme</strong><br/>Warm Knowledge</td>
- <td align="center" width="25%"><strong>Cyberpunk Theme</strong><br/>Neon Futuristic</td>
- <td align="center" width="25%"><strong>Apple Theme</strong><br/>Minimalist Elegant</td>
- <td align="center" width="25%"><strong>Aurora Theme</strong><br/>Gradient Flow</td>
- </tr>
- <tr>
- <td align="center">🟡 Education/Knowledge</td>
- <td align="center">💜 Tech/Innovation</td>
- <td align="center">⚪ Business/Professional</td>
- <td align="center">🌈 Creative/Artistic</td>
- </tr>
- </table>
- ### Component Examples
- | Component | Preview | Use Case |
- |-----------|---------|----------|
- | 🏷️ **Key Phrase** | _[Preview placeholder]_ | When guest mentions "Artificial General Intelligence", show "AI Development is Smooth Curve" |
- | 👤 **Lower Third** | _[Preview placeholder]_ | Show "Dario Amodei · CEO · Anthropic" at video start |
- | 📖 **Term Card** | _[Preview placeholder]_ | Auto popup explanation when "Moore's Law" first mentioned |
- | 💬 **Quote** | _[Preview placeholder]_ | Highlight "AI development is a very smooth exponential curve" |
- ---
- ## 📋 Use Cases
- <table>
- <tr>
- <td width="33%">
- ### 🎓 Educational Content
- - Knowledge sharing videos
- - Course recordings
- - Online lectures
- - Heavy terminology needs
- </td>
- <td width="33%">
- ### 🎙️ Interviews & Podcasts
- - Personal interviews
- - Panel discussions
- - Industry dialogues
- - Guest info display needs
- </td>
- <td width="33%">
- ### 📱 Social Media
- - YouTube long-form
- - B站 content
- - Podcast shows
- - Highlight clips needed
- </td>
- </tr>
- </table>
- ---
- ## 🎨 Theme System
- Choose the right theme based on content style:
- ```json
- {
- "theme": "notion" // or "cyberpunk", "apple", "aurora"
- }
- ```
- | Theme | Color Scheme | Characteristics | Best For |
- |-------|--------------|----------------|----------|
- | **Notion** | Warm Yellow + Blue | Soft gradients, knowledge-focused | Education, knowledge sharing, courses |
- | **Cyberpunk** | Neon Purple + Cyan | High contrast, tech-forward | Tech, sci-fi, innovation topics |
- | **Apple** | Black/White/Gray | Minimal, professional | Business, corporate, formal interviews |
- | **Aurora** | Rainbow Gradient | Flowing light, artistic | Creative, design, artistic content |
- ---
- ## 🧩 Component Configuration
- ### Complete Configuration Example
- <details>
- <summary>Expand to view full JSON config</summary>
- ```json
- {
- "theme": "notion",
- "lowerThirds": [
- {
- "name": "John Doe",
- "role": "Chief Scientist",
- "company": "AI Research Lab",
- "startMs": 1000,
- "durationMs": 5000
- }
- ],
- "chapterTitles": [
- {
- "number": "Part 1",
- "title": "The Journey of AI",
- "subtitle": "The History of AI Development",
- "startMs": 0,
- "durationMs": 4000
- }
- ],
- "keyPhrases": [
- {
- "text": "AI Development is Smooth Curve",
- "style": "emphasis",
- "startMs": 2630,
- "endMs": 5500
- }
- ],
- "termDefinitions": [
- {
- "chinese": "摩尔定律",
- "english": "Moore's Law",
- "description": "Number of transistors doubles every 18-24 months",
- "firstAppearanceMs": 37550,
- "displayDurationSeconds": 6
- }
- ],
- "quotes": [
- {
- "text": "AI development is a very smooth exponential curve",
- "author": "— John Doe",
- "startMs": 30000,
- "durationMs": 5000
- }
- ],
- "stats": [
- {
- "prefix": "Growth Rate ",
- "number": 240,
- "unit": "%",
- "label": "Annual Computing Power Growth",
- "startMs": 45000,
- "durationMs": 4000
- }
- ],
- "bulletPoints": [
- {
- "title": "Key Takeaways",
- "points": [
- "AI development is smooth exponential curve",
- "Similar to Moore's Law intelligence growth",
- "No sudden singularity moment"
- ],
- "startMs": 50000,
- "durationMs": 6000
- }
- ],
- "socialBars": [
- {
- "platform": "twitter",
- "label": "Follow us",
- "handle": "@ai_research",
- "startMs": 52000,
- "durationMs": 8000
- }
- ]
- }
- ```
- </details>
- ### Component Parameters Quick Reference
- | Component | Required | Optional | Notes |
- |-----------|----------|----------|-------|
- | Lower Third | name, role, company, startMs | durationMs (default 5s) | Guest information |
- | Chapter Title | number, title, startMs | subtitle, durationMs | Topic segmentation |
- | Key Phrase | text, startMs, endMs | style, position | **text must be phrase** |
- | Term Card | chinese, english, firstAppearanceMs | description, displayDurationSeconds | Terminology explanation |
- | Quote | text, author, startMs | durationMs, position | Memorable quotes |
- | Stats | number, label, startMs | prefix, unit, durationMs | Number display |
- | Bullet Points | title, points, startMs | durationMs | List summary |
- | Social Bar | platform, handle, startMs | label, durationMs | Follow CTA |
- > ⚠️ **Key Phrase Usage**: text must be a phrase (e.g., "AI Development is Smooth Curve"), not a single word (e.g., "Artificial Intelligence"). Use term cards for single words.
- ---
- ## 🗂️ Project Structure
- ```
- video-wrapper/
- ├── 📄 SKILL.md # Claude Skill definition
- ├── 📄 README.md # This document (English)
- ├── 📄 README_CN.md # Chinese documentation
- ├── 📄 ARCHITECTURE.md # Detailed architecture
- ├── 📄 requirements.txt # Python dependencies
- ├── 📁 src/ # Source code
- │ ├── video_processor.py # Main processing flow
- │ ├── browser_renderer.py # Playwright renderer
- │ ├── content_analyzer.py # AI content analysis
- │ ├── fancy_text.py # PIL key phrase rendering
- │ ├── term_card.py # PIL card rendering
- │ └── animations.py # Animation functions
- ├── 📁 templates/ # HTML templates
- │ ├── fancy-text.html
- │ ├── term-card.html
- │ ├── lower-third.html
- │ ├── chapter-title.html
- │ ├── quote-callout.html
- │ ├── animated-stats.html
- │ ├── bullet-points.html
- │ ├── social-bar.html
- │ └── video-config.json.template
- └── 📁 static/ # Static assets
- ├── css/ # Theme styles
- │ ├── effects.css
- │ ├── theme-notion.css
- │ ├── theme-cyberpunk.css
- │ ├── theme-apple.css
- │ └── theme-aurora.css
- └── js/
- └── anime.min.js # Animation engine
- ```
- ---
- ## ❓ FAQ
- <details>
- <summary><strong>Q: Playwright installation failed?</strong></summary>
- ```bash
- # Ensure Python version >= 3.8
- pip install playwright
- playwright install chromium
- # macOS may need to remove quarantine flag
- xattr -r -d com.apple.quarantine ~/.cache/ms-playwright
- # Verify installation
- playwright --version
- ```
- </details>
- <details>
- <summary><strong>Q: Processing too slow?</strong></summary>
- **Optimization Tips**:
- 1. Use PIL renderer: `-r pil` (simpler but 2-3x faster)
- 2. Lower video resolution (1080p → 720p)
- 3. Process long videos in segments (5-10 min chunks)
- 4. Reduce component count (keep only essentials)
- </details>
- <details>
- <summary><strong>Q: Out of memory?</strong></summary>
- **Solutions**:
- 1. Close other applications to free memory
- 2. Process long videos in segments
- 3. Use lower resolution (720p or 480p)
- 4. Reduce number of simultaneous components
- 5. Use PIL renderer (smaller memory footprint)
- </details>
- <details>
- <summary><strong>Q: Font display issues?</strong></summary>
- Ensure Chinese fonts are installed:
- ```bash
- # macOS - PingFang SC included
- # No additional installation needed
- # Ubuntu/Debian
- sudo apt-get install fonts-noto-cjk
- # CentOS/RHEL
- sudo yum install google-noto-sans-cjk-fonts
- # Verify fonts
- fc-list :lang=zh
- ```
- </details>
- <details>
- <summary><strong>Q: How to customize themes?</strong></summary>
- 1. Copy existing theme CSS file
- 2. Modify CSS variables
- 3. Specify new theme name in config
- See [ARCHITECTURE.md](./ARCHITECTURE.md#adding-new-themes) for details
- </details>
- ---
- ## 🔧 Tech Stack
- | Layer | Technology | Description |
- |-------|-----------|-------------|
- | **Visual Rendering** | HTML + CSS + Anime.js | Screenshot via Playwright browser |
- | **Video Compositing** | MoviePy | Python video editing library |
- | **Animation Engine** | Anime.js | Spring physics animations |
- | **Fallback Rendering** | Python PIL | Pure Python image processing |
- | **Content Analysis** | AI Analysis | Auto-identify key information |
- Detailed architecture available in [ARCHITECTURE.md](./ARCHITECTURE.md)
- ---
- ## 📚 Resources
- - [Claude Skills Documentation](https://docs.anthropic.com/claude/docs)
- - [MoviePy Documentation](https://zulko.github.io/moviepy/)
- - [Playwright Documentation](https://playwright.dev/python/)
- - [Anime.js Documentation](https://animejs.com/)
- ---
- ## 🤝 Contributing
- Issues and Pull Requests are welcome!
- Before submitting a PR, please ensure:
- - ✅ Code style follows project conventions
- - ✅ Added necessary tests
- - ✅ Updated relevant documentation
- ---
- ## 📄 License
- [MIT License](./LICENSE)
- ---
- <div align="center">
- **Powered by [Claude](https://claude.ai)**
- If you find this useful, please give it a ⭐️ Star!
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.