$npx -y skills add wells1137/media-skills --skill video-overlayAdds professional packaging and motion graphics to videos. Use when the user asks to add intros, outros, subtitles, transitions, watermarks, or lower thirds to a video. Supports multiple styles and custom options, no API key required.
| 1 | # Overlay Skill |
| 2 | |
| 3 | This skill adds a variety of professional packaging and motion graphics to videos, enhancing their overall quality. It supports both FFmpeg and MoviePy as backend engines and provides a rich set of preset templates and flexible custom parameters. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | Use this skill when the user asks to: |
| 8 | - "Add an intro/outro to my video" |
| 9 | - "Put subtitles on this clip" |
| 10 | - "Create a transition between these two shots" |
| 11 | - "Add my logo as a watermark" |
| 12 | - "Put a title card at the beginning" |
| 13 | - "Add a lower third with my name and title" |
| 14 | |
| 15 | ## Core Features |
| 16 | |
| 17 | | Feature | Description | Example Use Case | |
| 18 | | :--------------- | :--------------------------------------------- | :------------------------------------------------ | |
| 19 | | **Intro/Outro** | Add an engaging opening or a professional closing. | Brand logo animation, "Thanks for watching" screen. | |
| 20 | | **Subtitles/Titles** | Overlay static or dynamic text information. | Dialogue subtitles, chapter titles, call-to-action text. | |
| 21 | | **Transitions** | Create smooth or dynamic transitions between clips. | Fade between scenes, wipe to reveal next shot. | |
| 22 | | **Watermark/Borders** | Add copyright information or decorative borders. | Channel logo in corner, cinematic black bars. | |
| 23 | | **Lower Thirds** | Display names, locations, or other info. | Interviewee name and title, location identifier. | |
| 24 | |
| 25 | ## Usage Examples (Dialogue Format) |
| 26 | |
| 27 | ### 1. Add a Watermark |
| 28 | |
| 29 | **User:** "Can you add my logo to this video? It should be in the top right corner." |
| 30 | *User uploads `my_video.mp4` and `logo.png`* |
| 31 | |
| 32 | **Agent using `video-overlay`:** |
| 33 | ```bash |
| 34 | python /home/ubuntu/skills/video-overlay/scripts/add_watermark.py --input my_video.mp4 --output video_with_watermark.mp4 --image logo.png --position top_right |
| 35 | ``` |
| 36 | |
| 37 | ### 2. Add Subtitles |
| 38 | |
| 39 | **User:** "Add the subtitle 'Hello, world!' from 5 seconds to 10 seconds into the video." |
| 40 | *User uploads `my_video.mp4`* |
| 41 | |
| 42 | **Agent using `video-overlay`:** |
| 43 | ```bash |
| 44 | python /home/ubuntu/skills/video-overlay/scripts/add_subtitles.py --input my_video.mp4 --output video_with_subtitles.mp4 --text "Hello, world!" --start 00:00:05 --end 00:00:10 --style modern |
| 45 | ``` |
| 46 | |
| 47 | ## Resources |
| 48 | |
| 49 | - **`/scripts/`**: Contains the Python implementation code for all features. |
| 50 | - **`/templates/presets.json`**: A JSON file containing preset styles for intros, subtitles, and lower thirds. |
| 51 | - **`/references/ffmpeg_moviepy_cheatsheet.md`**: A cheatsheet with common commands and tips for FFmpeg and MoviePy. |