FCP Assistant

Auto video production, TTS voiceover, media management, batch export | AI 自动成片、TTS 配音、素材管理、批量导出. Triggers: FCP, Final Cut, make video, auto video, voiceover,...

Security Scan

The skill largely matches its stated purpose (automated Final Cut / video pipeline) but contains several inconsistencies and surprising defaults (missing referenced AppleScript files, hardcoded developer paths, and undocumented optional env usage) that warrant caution before installing.

Purpose & Capability

Name/description (FCP assistant, auto video/TTS/media management) align with the included scripts (media collection, TTS, auto-assembly, tagging, thumbnails). Required binaries (osascript, ffmpeg, ffprobe, curl, jq) are reasonable for the declared functionality. However, the registry metadata claims no OS restriction while the skill explicitly requires macOS/osascript in SKILL.md—this OS mismatch is an inconsistency. Overall capabilities match purpose but metadata and some defaults are sloppy.

Instruction Scope

SKILL.md and scripts instruct the agent to run many shell scripts and to call osascript for FCP automation. Some referenced assets appear missing: the README and SKILL.md call osascript scripts like scripts/check-fcp.scpt, scripts/list-projects.scpt, scripts/open-project.scpt, but .scpt files are not present in the file manifest. Several scripts contact local services (Qwen TTS at 127.0.0.1:7860, Qwen ASR at 127.0.0.1:8000) and external APIs (Pexels, Pixabay). Scripts read/write project files, /tmp, and may create outputs in user directories; that behavior is expected for this tool but the missing .scpt files and hard-coded developer paths (e.g., TTS_OUTPUT_DIR=/Users/stevegao/qwen-tts-webui/outputs) are surprising and could cause unexpected behavior or require editing before use.

Install Mechanism

No install spec provided (instruction/code bundle only), so nothing is fetched/installed by an external installer. The skill ships with shell scripts that will be written as part of the skill package; there is no remote download/install step declared. This is lower install risk, but running the provided scripts will execute local commands (ffmpeg, curl, osascript).

Credentials

The skill declares no required environment variables, which is mostly accurate for basic operation. However, multiple scripts reference optional environment/config items that are not declared: PEXELS_API_KEY (optional for media-collector), TTS host and local output directory defaults (127.0.0.1:7860 and /Users/stevegao/...), and the code uses local ports for ASR/TTS services. No secrets are explicitly requested, but the presence of an undocumented PEXELS_API_KEY usage and hardcoded user paths reduces clarity and could surprise users.

Persistence & Privilege

The skill is not always:on and does not request elevated platform privileges. It will create files under project directories and /tmp when run (normal for a media tool). There is no evidence it modifies other skills or system-wide agent config.

What to consider before installing

This skill appears to implement the advertised FCP/video pipeline, but review and test before trusting it with real projects: - Missing AppleScript files: SKILL.md calls multiple .scpt scripts (check-fcp.scpt, list-projects.scpt, etc.) but those .scpt files are not in the package. Expect to edit the scripts or provide your own .scpt files if you need FCP automation. - Local services required: TTS/ASR calls target local hosts (127.0.0.1:7860 and 127.0.0.1:8000). Ensure you run those services yourself — the skill assumes a local Qwen TTS/ASR stack. It will not contact a remote cloud TTS by default. - Hardcoded developer path: tts/voice scripts default TTS_OUTPUT_DIR to /Users/stevegao/..., which likely does not exist on your machine. Edit script defaults or set appropriate environment variables/directories before running. - Optional API key: media-collector mentions PEXELS_API_KEY (optional). If you supply an API key, it will be used in requests; no explicit secrets are required by the skill, but supplying keys is optional and should be done cautiously. - Network activity: the skill downloads video assets (Pexels) and references public music locations (Pixabay links). If you need an offline or air-gapped workflow, do not run the media-collector or block outbound network calls. - Safety steps before use: run the scripts in a disposable sandbox or inside a throwaway project directory; inspect and, if necessary, edit scripts for paths/ports; verify ffmpeg/osacscript calls on sample files; do not run against sensitive directories. If you rely on the FCP automation, create or supply the missing .scpt files or contact the author for a complete package. Given the above mismatches and surprising defaults, proceed only after addressing missing files and adjusting hardcoded paths; these issues look like sloppy packaging rather than intentionally malicious behavior.

Final Cut Pro Assistant

A fully automated video production pipeline — from script to final cut. Also your everyday FCP editing assistant.

---

🔥 Core Feature: AI Auto Video Production

One pipeline. Script in, video out.

Full Workflow

Script 📝 → Fetch Media 🔍 → TTS Voiceover 🎤 → Auto Assemble 🎞️ → Publish 🚀

Step 1: Fetch Video Assets

Auto-search and download free stock footage from Pexels by keywords.

bash scripts/media-collector.sh \
    --keywords "nature ocean sunset" \
    --count 5 --output ./my-project

• Multi-keyword search (searches each word separately, then merges)
• Orientation (landscape/portrait/square), quality (SD/HD/4K), duration filtering
• Saves metadata and license info automatically
• Set PEXELS_API_KEY for expanded search

Step 2: Add Background Music

Drop your BGM files (mp3/wav/m4a) into the project's music/ folder. The assembler auto-detects them.

my-project/
├── videos/     ← Stock footage (auto-filled by Step 1)
├── music/      ← Your BGM goes here
└── meta/       ← Metadata (auto-generated)

Step 3: TTS Voiceover

Generate per-paragraph voiceover using Qwen TTS.

bash scripts/tts-voiceover.sh \
    --script "First paragraph
Second paragraph
Third paragraph" \
    --output ./my-project/voiceover

• Per-paragraph generation with automatic silence trimming
• Customizable voice via --instruct (e.g., "warm female voice, moderate pace")
• Also reads from file: --script-file ./script.txt
• Requires Qwen TTS WebUI running at localhost:7860

Step 4: Auto Assemble

Combines footage, voiceover, subtitles, and BGM into a finished video.

bash scripts/auto-video-maker.sh \
    --project ./my-project \
    --script-file ./script.txt \
    --voiceover ./my-project/voiceover \
    --style vlog \
    --output final.mp4

Smart Features:

• 📝 Script split by paragraph, each mapped to a video clip
• 🎤 Clip duration auto-syncs to voiceover timing when available
• 📝 Burn-in subtitles with PingFang SC font (position/size adjustable)
• 🎵 Smart audio mixing — voiceover + BGM (BGM auto-ducked to 15%)
• 🎬 Fade transitions between clips
• 📐 Uniform resolution (default 1920x1080, supports portrait 1080x1920)

Style Presets:

Style	Pacing	Font Size	Transition	Best For
default	Medium	42	0.5s	General
vlog	Upbeat	38	0.3s	Daily vlogs
cinematic	Slow	48	1.0s	Scenic/story
fast	Rapid	36	0.2s	Shorts/TikTok

More Options:

--resolution 1080x1920    # Portrait mode
--no-subtitle             # No subtitles
--subtitle-pos center     # Center subtitles (default: bottom)
--font-size 50            # Custom font size
--music ./specific.mp3    # Specify BGM file
--transition none         # No transitions

---

📂 FCP Project Management

Automate everyday Final Cut Pro tasks.

osascript scripts/check-fcp.scpt          # Check FCP status
osascript scripts/list-projects.scpt       # List all projects
osascript scripts/open-project.scpt "Name" # Open a project
osascript scripts/import-temp-media.scpt   # Import temp media
osascript scripts/project-time-tracking.scpt  # Time tracking

---

✂️ Editing Assistance

bash scripts/scene-detect.sh video.mp4          # Scene detection
bash scripts/auto-rough-cut.sh video.mp4         # Auto rough cut (silence removal)
bash scripts/smart-tagger.sh ./media/            # AI smart tagging
bash scripts/auto-chapter-marker.sh video.mp4    # Auto chapter markers

---

🔊 Audio Processing

bash scripts/audio-normalizer.sh video.mp4       # Normalize to -23 LUFS
bash scripts/auto-voiceover.sh "text" out.wav    # Single-file voiceover

---

🌍 Subtitles

bash scripts/multi-lang-subtitles.sh video.mp4 en   # Multi-language (en/ja/ko/fr/de/es)

---

🖼️ Other Tools

bash scripts/auto-thumbnail.sh video.mp4 ./thumbs   # Keyframe thumbnails + contact sheet
osascript scripts/create-script.scpt "Title" "Content"  # Create script in Notes
osascript scripts/list-scripts.scpt                  # List scripts

---

Requirements

• Required: macOS, ffmpeg (with drawtext/libass), osascript
• TTS: Qwen TTS WebUI (localhost:7860)
• Media Search: Internet (Pexels API, free)
• Recommended: brew install homebrew-ffmpeg/ffmpeg/ffmpeg (includes drawtext + libass)

---

From script to screen — let AI make your videos! 🎬

---

---

中文版

Final Cut Pro 助手

从文案到成片的全自动视频生产线，同时也是你的 FCP 剪辑助手。

---

🔥 核心能力：AI 自动视频生产

一条命令，从文案到成品视频。

完整工作流

文案 📝 → 搜素材 🔍 → TTS 配音 🎤 → 自动成片 🎞️ → 发布 🚀

Step 1: 搜集视频素材

从 Pexels 免费素材库自动搜索下载，按关键词匹配。

bash scripts/media-collector.sh \
    --keywords "nature ocean sunset" \
    --count 5 --output ./my-project

• 多关键词自动逐词搜索
• 支持方向（横屏/竖屏）、质量（SD/HD/4K）、时长范围筛选
• 自动保存素材元数据和版权信息
• 设置 PEXELS_API_KEY 解锁更多搜索能力

Step 2: 准备背景音乐

把你找的 BGM 放到项目的 music/ 目录即可，成片时自动检测。

my-project/
├── videos/     ← 素材（Step 1 自动填充）
├── music/      ← 你的 BGM 放这里（mp3/wav/m4a）
└── meta/       ← 元数据（自动生成）

Step 3: TTS 配音

用 Qwen TTS 为每段文案生成配音。

bash scripts/tts-voiceover.sh \
    --script "第一段文案
第二段文案
第三段文案" \
    --output ./my-project/voiceover

• 逐段生成，自动修剪首尾静音
• 声音特征可自定义（--instruct）
• 也支持从文件读取：--script-file ./script.txt
• 需要 Qwen TTS WebUI 运行在 localhost:7860

Step 4: 自动成片

把素材、配音、字幕、BGM 全部组装成完整视频。

bash scripts/auto-video-maker.sh \
    --project ./my-project \
    --script-file ./script.txt \
    --voiceover ./my-project/voiceover \
    --style vlog \
    --output final.mp4

智能特性：

• 📝 文案按段落拆分，每段对应一个视频片段
• 🎤 有配音时，片段时长自动匹配配音节奏
• 📝 PingFang SC 简体中文字幕烧入（位置/大小可调）
• 🎵 配音 + BGM 智能混合（BGM 自动降低到 15% 音量）
• 🎬 fade 转场效果
• 📐 统一分辨率（默认 1920x1080，支持竖屏 1080x1920）

风格预设：

风格	节奏	字号	转场	适合
default	中等	42	0.5s	通用
vlog	轻快	38	0.3s	日常 Vlog
cinematic	缓慢	48	1.0s	电影感
fast	快速	36	0.2s	短视频/抖音

---

📂 FCP 项目管理

osascript scripts/check-fcp.scpt          # 检查 FCP 状态
osascript scripts/list-projects.scpt       # 列出所有项目
osascript scripts/open-project.scpt "名称"  # 打开项目
osascript scripts/import-temp-media.scpt   # 导入临时素材
osascript scripts/project-time-tracking.scpt  # 时间追踪

✂️ 剪辑辅助

bash scripts/scene-detect.sh video.mp4     # 场景分析
bash scripts/auto-rough-cut.sh video.mp4   # 自动粗剪
bash scripts/smart-tagger.sh ./media/      # 智能标签
bash scripts/auto-chapter-marker.sh video.mp4  # 自动章节标记

🔊 音频处理

bash scripts/audio-normalizer.sh video.mp4 # 音频标准化 (-23 LUFS)
bash scripts/auto-voiceover.sh "文本" out.wav  # 单文件配音

🌍 字幕

bash scripts/multi-lang-subtitles.sh video.mp4 en  # 多语言字幕

🖼️ 其他工具

bash scripts/auto-thumbnail.sh video.mp4 ./thumbs  # 自动缩略图
osascript scripts/create-script.scpt "标题" "内容"   # 创建文案
osascript scripts/list-scripts.scpt                 # 列出文案

---

依赖

• 必需: macOS, ffmpeg (with drawtext/libass), osascript
• TTS 配音: Qwen TTS WebUI (localhost:7860)
• 素材搜索: 网络连接（Pexels API，免费）
• 推荐: brew install homebrew-ffmpeg/ffmpeg/ffmpeg

---

从文案到成片，让 AI 帮你做视频！🎬

Made by Steve & Steven 🤝