viral-video-platform-specs — Claude Code skill for video export
The viral-video-platform-specs Claude Code skill selects export settings for social video platforms. It activates for upload specs, aspect-ratio changes, and multi-platform exports.
MIT 108 installs ★ 66 updated 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a claude-codeWhat viral-video-platform-specs does
The skill selects export settings for TikTok, YouTube Shorts, Instagram Reels, Facebook Reels, Snapchat Spotlight, and Twitter/X. Its reference includes platform tables, FFmpeg presets, batch-export examples, and file-size calculations. It also describes checking finished videos with ffprobe.
Video encoding requires ffmpeg; the skill starts by checking it with ffmpeg -version. The general profile uses H.264 and AAC, while aspect ratio, loudness, and file size settings vary by platform. Social platforms re-encode uploads, and the reference covers two-pass bitrate control for strict file-size limits.
What it helps with
- choose a codec and resolution for a video
- convert footage to a 9:16 frame
- estimate a file's size before upload
- prepare exports for several social platforms
- check a finished file with
ffprobe
Example prompts for the agent
- Choose export settings for TikTok and Instagram Reels.
- Convert
input.mp4to a 9:16 format for YouTube Shorts. - Prepare a batch export for several social platforms with a file-size limit.
How to install viral-video-platform-specs
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a claude-code2Manually: put the files in place
~/.claude/skills/viral-video-platform-specs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/viral-video-platform-specs/
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a codex2Manually: put the files in place
.agents/skills/viral-video-platform-specs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a cursor2Manually: put the files in place
.cursor/skills/viral-video-platform-specs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/ffmpeg-social-video/skills/viral-video-platform-specs2Manually: put the files in place
.github/skills/viral-video-platform-specs/SKILL.md1Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a gemini-cli2Platform CLI
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/ffmpeg-social-video/skills/viral-video-platform-specsManually: put the files in place
.devin/skills/viral-video-platform-specs/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about viral-video-platform-specs
How do I install viral-video-platform-specs in Claude Code?
Run npx skills add JosiahSiegel/claude-plugin-marketplace --skill viral-video-platform-specs -a claude-code. The skill file is at ~/.claude/skills/viral-video-platform-specs/SKILL.md.
What does viral-video-platform-specs do?
It selects video export parameters for social platforms, including codecs and frame dimensions. The reference includes FFmpeg presets and platform-specific tables.
What does viral-video-platform-specs need to work?
Video encoding requires ffmpeg; finished files can be checked with ffprobe.
Source text
SKILL.md · MIT
--- name: viral-video-platform-specs description: | Complete platform upload specifications for viral video creation across TikTok, YouTube Shorts, Instagram Reels, Facebook Reels, Snapchat Spotlight, and Twitter/X. PROACTIVELY activate for: (1) Platform-specific video encoding, (2) Upload requirements lookup, (3) Multi-platform export, (4) File size optimization, (5) Aspect ratio conversion, (6) Duration limits, (7) Audio requirements, (8) Caption/subtitle specs, (9) Thumbnail requirements, (10) Quality vs compatibility trade-offs. Provides: Comprehensive spec tables, FFmpeg presets per platform, optimal encoding settings, file size calculators, batch export workflows, and 2025-2026 platform-specific algorithm insights. --- # Viral Video Platform Specifications Use this skill to choose export settings for TikTok, YouTube Shorts, Instagram Reels, Facebook Reels, Snapchat Spotlight, Twitter/X, Pinterest, LinkedIn, and mobile-browser playback. This SKILL is a lean orchestrator; detailed platform tables, commands, and recipes are preserved in `references/platform-details-and-recipes.md`. ## Quick Reference | Platform | Aspect | Recommended resolution | Practical duration | Max size | Default codec | |---|---:|---:|---:|---:|---| | TikTok | 9:16 | 1080x1920 | 21-34s | 287 MB iOS | H.264 + AAC | | YouTube Shorts | 9:16 | 1080x1920 | 50-59s | 256 GB | H.264 or VP9 | | Instagram Reels | 9:16 | 1080x1920 | 7-30s | 4 GB | H.264 + AAC | | Facebook Reels | 9:16 | 1080x1920 | 15-30s | 4 GB | H.264 + AAC | | Snapchat Spotlight | 9:16 | 1080x1920 | <=60s | 300 MB | H.264 + AAC | | Twitter/X | 9:16, 16:9, 1:1 | 1080x1920 | <=140s | 512 MB | H.264 + AAC | ## Universal Social Export Baseline ```bash ffmpeg -i input.mp4 \ -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black,setsar=1,fps=30" \ -c:v libx264 -preset medium -crf 22 -profile:v high -level 4.1 \ -c:a aac -b:a 192k -ar 48000 -ac 2 \ -pix_fmt yuv420p -movflags +faststart \ output_social.mp4 ``` Adjust loudness, duration, bitrate, and metadata per platform from the reference file. ## Core Workflow 1. Verify `ffmpeg -version`; prefer current stable builds for security and codec fixes. 2. Identify target platform(s) and whether the video is native-app upload or mobile-browser playback. 3. Normalize to vertical 9:16 unless the platform or campaign calls for square/horizontal. 4. Use H.264/AAC for the broadest acceptance. Use VP9 only when intentionally targeting YouTube/WebM. 5. Apply platform loudness targets: TikTok/Reels often around -10 to -12 LUFS; YouTube around -14 LUFS; Facebook around -13 LUFS. 6. Keep `-pix_fmt yuv420p` and `-movflags +faststart` for compatibility. 7. Verify output with `ffprobe` before upload. ## Key Gotchas - All major social platforms re-encode uploads; high-quality H.264 is usually a better upload source than HEVC/AV1 for social delivery. - For web/mobile-browser playback, profile/level, `yuv420p`, and faststart matter more than platform upload limits. - Keep captions and UI out of unsafe top/bottom regions, especially lower 35% on Reels-style interfaces. - Two-pass bitrate control is useful when a platform file-size ceiling is strict. ## Reference Map - `references/platform-details-and-recipes.md` - Full preserved reference: per-platform spec tables, FFmpeg presets, two-pass examples, multi-platform export script, file-size calculation, codec comparison, mobile-safe playback, color grading, text/caption readability, verification commands, sources. ## Related Skills - `viral-video-animated-captions` - CapCut-style caption generation - `viral-video-hook-templates` - Hook patterns and retention tactics - `ffmpeg-animation-timing-reference` - Timing, readability, sync, and platform pacing - `ffmpeg-command-syntax` - Correct option placement
© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace