← Back to Skills Marketplace
449
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install skill-video-caption-overlay
Description
Render TikTok-style animated pill captions onto short-form videos using MoviePy + PIL. Takes a base MP4, a captions JSON, and optional background audio — out...
Usage Guidance
This skill appears to be what it says: a local Python script that overlays animated pill captions on videos. Things to check before running: 1) Fix the hardcoded font defaults — the script uses '/home/aladdin/.local/share/fonts/...' even though the README says '~/.local/share/fonts/'; change those defaults to use os.path.expanduser('~/.local/...') or pass --font-black/--font-bold with absolute paths. 2) Run the script on sample files first to confirm behavior and avoid pointing it at sensitive system files. 3) Confirm you trust the source before running — although no network calls or credential access are present, the script will read any file path you give it and write the output file. 4) Ensure you have uv, moviepy, and pillow installed in a controlled environment (virtualenv/container) if you want to limit side effects.
Capability Analysis
Type: OpenClaw Skill
Name: skill-video-caption-overlay
Version: 1.0.0
The skill is classified as suspicious due to a hardcoded, non-portable file path in `scripts/overlay.py`. The script defaults to `/home/aladdin/.local/share/fonts/Montserrat-Black.ttf` and `/home/aladdin/.local/share/fonts/Montserrat-Bold.ttf` for font files if not explicitly provided. While not directly malicious, this constitutes a vulnerability as it leaks a specific username ('aladdin'), is unlikely to work for most users, and accesses a path outside the skill's bundle and common system-wide font directories, which is a risky capability without clear malicious intent. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection in any of the files.
Capability Assessment
Purpose & Capability
Name/description match the included Python script. The single required binary 'uv' is consistent with the documented 'uv run' usage. Dependencies (moviepy, pillow) are exactly what the task needs.
Instruction Scope
SKILL.md instructs the agent to run the included script on a user-supplied video, captions JSON, and optional audio only — which matches the code. However, SKILL.md claims fallback to fonts in '~/.local/share/fonts/', while the script defaults to the absolute path '/home/aladdin/.local/share/fonts/...'. This hardcoded user home path is an inconsistency (likely an author oversight) and could cause the script to fail or attempt to read another user's files on multi-user systems.
Install Mechanism
No install spec is provided (instruction-only), and the script relies on well-known Python packages via 'uv --with' flags. There are no downloads from external URLs or archive extraction steps in the skill bundle.
Credentials
The skill requires no environment variables or credentials. It only reads files the user passes as arguments (video, captions JSON, optional audio, optional font paths).
Persistence & Privilege
always is false and the skill does not request persistent/system-wide privileges or modify other skills. Model invocation is permitted (the platform default) but, given the script's local-file nature, autonomous invocation would simply run the overlay on files the agent is given.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill-video-caption-overlay - After installation, invoke the skill by name or use
/skill-video-caption-overlay - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of video caption overlay tool.
- Render TikTok-style animated pill captions onto short-form videos using MoviePy and PIL.
- Accepts a base MP4 video, captions JSON, and optional background audio.
- Outputs a final video with fade-in/out pill overlays for each caption phase.
- Implements a fix for the PIL textbbox y-offset bug to properly center text within pill overlays.
- Supports custom fonts and detailed caption styling through JSON configuration.
Metadata
Frequently Asked Questions
What is Skill Video Caption Overlay?
Render TikTok-style animated pill captions onto short-form videos using MoviePy + PIL. Takes a base MP4, a captions JSON, and optional background audio — out... It is an AI Agent Skill for Claude Code / OpenClaw, with 449 downloads so far.
How do I install Skill Video Caption Overlay?
Run "/install skill-video-caption-overlay" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill Video Caption Overlay free?
Yes, Skill Video Caption Overlay is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Skill Video Caption Overlay support?
Skill Video Caption Overlay is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill Video Caption Overlay?
It is built and maintained by Zero2Ai (@zero2ai-hub); the current version is v1.0.0.
More Skills