wjs-reframing-video

Convert video orientation between horizontal and vertical while preserving aspect ratio.

114|17|Updated May 11, 2026
One-click install
npx skills add https://github.com/jianshuo/claude-skills --skill wjs-reframing-video
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wjs-reframing-video
Source: https://github.com/jianshuo/claude-skills/tree/main/wjs-reframing-video
Command: npx skills add https://github.com/jianshuo/claude-skills --skill wjs-reframing-video

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mediapipe, opencv-python, numpy, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the need to repurpose video content by converting orientation between horizontal and vertical formats while preserving the aspect ratio and ensuring the active speaker stays in frame.

Core Features & Use Cases

  • Active Speaker Tracking: The skill uses MediaPipe to track the active speaker's face and keep them in the frame during conversion.
  • Aspect Ratio Preservation: It maintains the original aspect ratio when converting from horizontal to vertical or vice versa.
  • Use Case: If you have a 16:9 video that you want to repurpose for vertical platforms like TikTok, you can use this skill to convert the video orientation while ensuring the speaker remains visible.

Quick Start

To convert a video from horizontal to vertical and keep the active speaker in frame, use the following command: /wjs-reframing-video --target portrait <input-video>

Frequently Asked Questions about wjs-reframing-video

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

FAQPage Schema
How do I convert horizontal video to vertical for TikTok while keeping the speaker in frame?

To convert horizontal video to vertical for TikTok while keeping the speaker in frame, use a tool that performs active speaker tracking. This Skill utilizes MediaPipe to track the speaker's face and ffmpeg to crop and scale, preserving the aspect ratio for portrait platforms.

How does active speaker tracking work during video aspect ratio conversion?

Active speaker tracking during video aspect ratio conversion works by utilizing MediaPipe to monitor mouth-aspect-ratio variance. This mechanism identifies the actively speaking individual and dynamically adjusts the crop to ensure they remain visible in the new orientation.

Do I need ffmpeg and MediaPipe to automate vertical video cropping?

Yes, you need ffmpeg and MediaPipe to automate vertical video cropping with this Skill. MediaPipe handles the active speaker tracking via facial landmark analysis, while ffmpeg performs the actual video cropping and scaling to preserve the aspect ratio.

What's the best way to repurpose 16:9 video content for portrait orientation?

The best way to repurpose 16:9 video content for portrait orientation is to use active speaker tracking combined with ffmpeg cropping. This ensures the aspect ratio is preserved and the speaker remains centered without manual frame adjustment.

Can I convert vertical video back to horizontal using ffmpeg and OpenCV?

Yes, you can convert vertical video back to horizontal using this Skill's ffmpeg and OpenCV integration. It converts video orientation between horizontal and vertical formats while preserving the original aspect ratio and keeping the active speaker tracked by MediaPipe in frame.

Why does my speaker disappear when converting video orientation between horizontal and vertical?

Your speaker disappears when converting video orientation because standard cropping often removes the subject. This Skill solves this by using MediaPipe for active speaker tracking via mouth-aspect-ratio variance, dynamically adjusting the crop to keep the speaker in frame.