ClaudeCodewithRemotion: Skill for Claude Code

When to use

Use this skill when the user wants to create a short-form video (Reels/TikTok/Shorts) from raw footage using the AI auto-editing pipeline. Trigger keywords: "edit video", "create short", "auto edit", "short video", "remotion edit", "剪輯".

Overview

This is a complete AI-powered video editing workflow:

[Raw Footage] → [素材確認] → [使用者標註重點] → [Gemini Analyze] → [討論主題與方向] → [OpenAI Script] → [使用者確認腳本] → [Remotion Compose] → [Render]

Full Workflow

Follow these steps in order. Each step has specific notes and checkpoints.

---

Pre-flight: Environment Check

This step runs automatically every time the skill is triggered. Run all checks before proceeding. If any check fails, fix it before moving on.

# 1. Check if this is a Remotion project (package.json exists with remotion deps)
cat package.json | grep -q '"remotion"' && echo "✅ Remotion project detected" || echo "❌ Not a Remotion project"

# 2. Check required npm packages
for pkg in "@remotion/cli" "@remotion/transitions" "@remotion/media" "@google/generative-ai" "openai" "dotenv"; do
  node -e "require('$pkg')" 2>/dev/null && echo "✅ $pkg" || echo "❌ $pkg missing"
done

# 3. Check .env file exists and has required keys
if [ -f .env ] || [ -f ../.env ]; then
  echo "✅ .env file found"
  grep -q "GEMINI_API_KEY" .env 2>/dev/null || grep -q "GEMINI_API_KEY" ../.env 2>/dev/null && echo "✅ GEMINI_API_KEY set" || echo "❌ GEMINI_API_KEY missing"
  grep -q "GEMINI_MODEL" .env 2>/dev/null || grep -q "GEMINI_MODEL" ../.env 2>/dev/null && echo "✅ GEMINI_MODEL set" || echo "❌ GEMINI_MODEL missing"
  grep -q "OPENAI_API_KEY" .env 2>/dev/null || grep -q "OPENAI_API_KEY" ../.env 2>/dev/null && echo "✅ OPENAI_API_KEY set" || echo "❌ OPENAI_API_KEY missing"
  grep -q "OPENAI_MODEL" .env 2>/dev/null || grep -q "OPENAI_MODEL" ../.env 2>/dev/null && echo "✅ OPENAI_MODEL set" || echo "❌ OPENAI_MODEL missing"
else
  echo "❌ .env file not found"
fi

# 4. Check ffprobe available
which ffprobe >/dev/null 2>&1 && echo "✅ ffprobe available" || echo "❌ ffprobe not found (install FFmpeg)"

# 5. Check public/ directory exists
[ -d public ] && echo "✅ public/ directory exists" || echo "❌ public/ directory missing"

# 6. Check tsconfig has resolveJsonModule
grep -q "resolveJsonModule" tsconfig.json 2>/dev/null && echo "✅ resolveJsonModule enabled" || echo "⚠️ resolveJsonModule not set in tsconfig.json"

# 7. Check scripts directory structure
[ -d scripts/output ] && echo "✅ scripts/output/ exists" || echo "⚠️ scripts/output/ missing (will be created)"