media-pipeline

Generates multi-scene videos from text prompts via Agnes image-to-video APIs with state machine retries and ffmpeg concatenation.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/Lucien-1127/strata-skill --skill media-pipeline-lucien-1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: media-pipeline
Source: https://github.com/Lucien-1127/strata-skill/tree/main/media-pipeline
Command: npx skills add https://github.com/Lucien-1127/strata-skill --skill media-pipeline-lucien-1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? Turning a single topic into a complete multi-scene video requires manually coordinating text-to-image generation, image-to-video rendering, polling, downloading, and concatenation, with failures at any step breaking the whole run. This Skill automates that entire pipeline using a Finite Execution Graph with a per-scene state machine, quality-gate hooks, and automatic retry/skip logic. ## Core Features & Use Cases - FEG + State Machine Pipeline: Each scene flows through IMAGE_GEN, VIDEO_GEN, POLLING, DOWNLOADING, and COMPLETE states with up to 3 automatic retries and graceful skipping of failed scenes. - Quality-Gate Hooks: Pre-flight checks (API key symlink, httpx, ffmpeg, disk space), post-image/post-video URL validation, and pre-concat resolution checks via ffprobe. - Character Consistency Mode: idol-video.py locks a reference image across all scenes so the character appearance stays consistent, with negative prompts preventing identity drift. - Use Case: Ask for a 5-scene animated short about a topic; the pipeline generates images with Agnes Image 2.1 Flash, renders clips with Agnes Video V2.0, downloads each MP4, and concatenates them with ffmpeg into one final video. ## Quick Start Run the FEG pipeline script with a topic, scene count, and duration to automatically generate and concatenate a multi-scene video.

Frequently Asked Questions about media-pipeline

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

FAQPage Schema
How do I generate a multi-scene video from a text prompt?▼

Run pipeline-feg.py with a topic, scene count, and per-scene duration. It generates an image per scene with Agnes Image 2.1 Flash, renders video with Agnes Video V2.0, downloads each MP4, and concatenates them with ffmpeg into one final file.

How do I keep a character consistent across AI-generated video scenes?▼

Use idol-video.py with a shared --ref-image URL so every scene starts from the same reference frame. The script automatically adds negative prompts against face changes and identity drift, and you can add --crossfade for smoother transitions.

What are the requirements to run the Agnes video pipeline?▼

You need an AGNES_API_KEY in ~/.hermes/env/agnes.env, the Python httpx package, and ffmpeg installed for concatenation. The pre-flight hook checks all of these plus at least 500MB of free disk space before starting.

Why does the pipeline skip scenes after image generation succeeds?▼

Older versions had a safety check whose holding-state set omitted intermediate states like IMAGE_DONE and VIDEO_DONE, causing false 'state unchanged' skips. This was fixed by including all legitimate intermediate states in the check.

What are the limitations of the Agnes Video V2.0 API?▼

A single clip is limited to about 18 seconds at 24 fps with frame counts following the 8n+1 rule, up to 441 frames. Longer videos must be assembled by concatenating multiple clips with ffmpeg at matching resolution and encoding.