← Back to Skills Marketplace
kirkraman

ai-video-gen

by KirkRaman · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
59
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install godfery-ai-video-gen
Description
End-to-end AI video generation - create videos from text prompts using image generation, video synthesis, voice-over, and editing. Powered by SkillBoss API H...
README (SKILL.md)

AI Video Generation Skill

Generate complete videos from text descriptions using AI.

Capabilities

  1. Image Generation - via SkillBoss API Hub (auto-routed to best model)
  2. Video Generation - via SkillBoss API Hub (auto-routed to best model)
  3. Voice-over - via SkillBoss API Hub TTS
  4. Video Editing - FFmpeg assembly, transitions, overlays

Quick Start

# Generate a complete video
python skills/ai-video-gen/generate_video.py --prompt "A sunset over mountains" --output sunset.mp4

# Just images to video
python skills/ai-video-gen/images_to_video.py --images img1.png img2.png --output result.mp4

# Add voiceover
python skills/ai-video-gen/add_voiceover.py --video input.mp4 --text "Your narration" --output final.mp4

Setup

Required API Keys

Add to your environment or .env file:

SKILLBOSS_API_KEY=your-skillboss-api-key

Install Dependencies

pip install requests pillow python-dotenv

FFmpeg

Already installed via winget.

Usage Examples

1. Text to Video (Full Pipeline)

python skills/ai-video-gen/generate_video.py \
  --prompt "A futuristic city at night with flying cars" \
  --duration 5 \
  --voiceover "Welcome to the future" \
  --output future_city.mp4

2. Multiple Scenes

python skills/ai-video-gen/multi_scene.py \
  --scenes "Morning sunrise" "Busy city street" "Peaceful night" \
  --duration 3 \
  --output day_in_life.mp4

3. Image Sequence to Video

python skills/ai-video-gen/images_to_video.py \
  --images frame1.png frame2.png frame3.png \
  --fps 24 \
  --output animation.mp4

Workflow Options

Balanced Mode

  • Image: SkillBoss API Hub (auto-selects best model, prefer: balanced)
  • Video: SkillBoss API Hub (auto-selects best model, prefer: balanced)
  • Voice: SkillBoss API Hub TTS
  • Edit: FFmpeg

Quality Mode

  • Image: SkillBoss API Hub (prefer: quality)
  • Video: SkillBoss API Hub (prefer: quality)
  • Voice: SkillBoss API Hub TTS
  • Edit: FFmpeg + effects

Scripts Reference

  • generate_video.py - Main end-to-end generator
  • images_to_video.py - Convert image sequence to video
  • add_voiceover.py - Add narration to existing video
  • multi_scene.py - Create multi-scene videos
  • edit_video.py - Apply effects, transitions, overlays

Examples

See examples/ folder for sample outputs and prompts.

Usage Guidance
Before installing or running: 1) Don't paste your SKILLBOSS_API_KEY into a remote form — the scripts send it to https://api.heybossai.com/v1; verify the service is trustworthy and you understand its privacy policy. 2) Confirm the missing items: .env.example, multi_scene.py, edit_video.py, and examples/ are absent — ask the publisher for the full package or audit the code you received. 3) Treat the registry metadata omission (it doesn't list SKILLBOSS_API_KEY) as a warning — prefer skills whose declared requirements match their code. 4) Run the scripts in an isolated environment (throwaway account or sandbox) and review network calls (e.g., with a proxy) if you must supply an API key. 5) If you need higher assurance, request source/origin information or a homepage from the owner before providing credentials.
Capability Analysis
Type: OpenClaw Skill Name: godfery-ai-video-gen Version: 1.0.0 The skill bundle provides a legitimate set of tools for AI video generation, including image synthesis, text-to-speech, and video assembly using FFmpeg and the SkillBoss API (api.heybossai.com). The Python scripts (generate_video.py, add_voiceover.py, and images_to_video.py) implement the stated functionality using standard libraries and safe subprocess execution patterns. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The code (generate_video.py, add_voiceover.py, images_to_video.py) implements image/video/TTS workflows against a SkillBoss API and FFmpeg as described — that part is coherent. However, the registry metadata declares no required env vars while SKILL.md, QUICK_START.md, README.md, and the scripts all require SKILLBOSS_API_KEY. The docs also reference .env.example, multi_scene.py, edit_video.py, and an examples/ folder that are not present in the manifest. These mismatches are inconsistent and should be resolved.
Instruction Scope
SKILL.md instructions stay within the stated purpose (call remote API for images/videos/tts, use FFmpeg locally). The runtime scripts only access the SKILLBOSS_API_KEY env var and local media files. No instructions ask to read unrelated system files or other credentials. Note: the docs instruct copying a .env.example (which is missing) and reference additional scripts not included — this could confuse users.
Install Mechanism
There is no install spec (instruction-only). Dependencies are standard Python packages listed in requirements.txt; no external downloads or archive extraction are performed by the skill bundle itself.
Credentials
The code legitimately requires a single service credential (SKILLBOSS_API_KEY) for the SkillBoss API, which is proportionate to the functionality. However, the registry metadata incorrectly lists no required env vars or primary credential — this metadata omission is a red flag because it hides that a secret must be provided to an external service. Users should treat providing an API key to an unknown/undocumented service domain with caution.
Persistence & Privilege
The skill does not request persistent/always-on installation and uses normal, user-invoked scripts. It does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install godfery-ai-video-gen
  3. After installation, invoke the skill by name or use /godfery-ai-video-gen
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of AI Video Generation Skill. - Generate videos from text prompts using integrated image generation, video synthesis, and TTS voice-over. - Auto-selects best models via SkillBoss API Hub for image/video/voice tasks. - Includes FFmpeg-based video assembly, editing, and transitions. - Provides multiple scripts for full pipeline, scene-based, and modular workflows. - Setup instructions and example usages included for quick start.
Metadata
Slug godfery-ai-video-gen
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is ai-video-gen?

End-to-end AI video generation - create videos from text prompts using image generation, video synthesis, voice-over, and editing. Powered by SkillBoss API H... It is an AI Agent Skill for Claude Code / OpenClaw, with 59 downloads so far.

How do I install ai-video-gen?

Run "/install godfery-ai-video-gen" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ai-video-gen free?

Yes, ai-video-gen is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ai-video-gen support?

ai-video-gen is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ai-video-gen?

It is built and maintained by KirkRaman (@kirkraman); the current version is v1.0.0.

💬 Comments