Run any Skill in Manus with one click

$pwd:

scrollclaw-animate

Name: Scrollclaw Animate
Author: TheMattBerman

// Animate first frames into A-roll talking head clips. Uses Sora 2 via fal.ai (primary) with Kling 3 auto-fallback when Sora is unavailable or sunset.

Run Skill in Manus

$ git log --oneline --stat

stars:59

forks:15

updated:March 26, 2026 at 07:23

File Explorer

3 files

SKILL.md

readonly

name	scrollclaw-animate
description	Animate first frames into A-roll talking head clips. Uses Sora 2 via fal.ai (primary) with Kling 3 auto-fallback when Sora is unavailable or sunset.
metadata	{"openclaw":{"emoji":"🎥","user-invocable":true,"triggers":["animate clip","sora animate","generate clip","a-roll","talking head clip","sora video","kling animate","kling a-roll"]}}

Animate (A-Roll)

Turns first frames into talking head clips with synced lip movement and audio. Image-to-video is the default — text-to-video is the fallback.

Fallback chain: Sora 2 (fal.ai) -> Kling 3 (fal.ai) -> Kling 3 (Replicate). Use --provider kling to skip Sora entirely (for when Sora is sunset).

Prerequisites

First frame approved (from /first-frame)
Script with [A-ROLL] segments tagged (from /persona)

Motion Prompting

Read references/motion-prompting.md for the structured prompt format. Use labeled fields — not prose paragraphs:

Camera — handheld energy, micro-shake, slight reframe
Subject — keep generic (first frame defines appearance). Detailed facial descriptions trigger content safety filters
Dialogue — include actual script lines. Sora generates synced lip movement + audio
Audio — describe the RESULT not the gear. "Clean natural podcast audio, voice close and present, subtle room tone" works. Naming specific mics doesn't.
Environment & light — practical light, deep focus, real-world setting
Style & mood — iPhone selfie-camera realism, not cinematic

Generation

USE THE SCRIPTS. DO NOT construct API calls manually. Scripts handle provider routing, field names, polling, downloading, and error handling.

# Image-to-video (RECOMMENDED — first frame locks the face)
bash scripts/generate-clip.sh \
  --provider fal \
  --image workspace/campaigns/<slug>/frames/frame1.png \
  --prompt-file workspace/campaigns/<slug>/motion-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

# Text-to-video (fallback — no first frame)
bash scripts/generate-clip.sh \
  --provider fal \
  --prompt-file workspace/campaigns/<slug>/scene-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

# Kling direct (skip Sora — use when Sora is sunset)
bash scripts/generate-clip.sh \
  --provider kling \
  --image workspace/campaigns/<slug>/frames/frame1.png \
  --prompt-file workspace/campaigns/<slug>/motion-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

# Replicate Sora (legacy — may stop working when Sora is sunset)
bash scripts/generate-clip.sh \
  --provider replicate \
  --image workspace/campaigns/<slug>/frames/frame1.png \
  --prompt-file workspace/campaigns/<slug>/motion-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

API Reference

Read references/sora-api.md for endpoint details, queue workflow, field names, and duration options. Sora fal.ai supports 4/8/12/16/20s. Kling supports 3-15s (durations >15s are auto-clamped). Replicate Sora is limited to 4/8/12.

Content Filter Handling

Sora's content filter runs AFTER generation — can fail at 99%. If blocked:

Soften the motion prompt (keep first frame)
Remove any potentially sensitive descriptions
Retry with adjusted prompt
Or use --provider kling — Kling has no content safety filter

Key Findings

Include actual script in Dialogue field — Sora generates synced lip movement
For podcast audio: describe the RESULT, not the gear
Keep Subject descriptions generic — the first frame already defines appearance
fal.ai is primary provider; Kling 3 is auto-fallback when Sora fails or is sunset
Use --provider kling to skip Sora entirely

Brand Memory Integration

Reads

File	Purpose
`workspace/campaigns/<slug>/frames/frame1.png`	Canonical face — fed to Sora i2v to lock creator identity
`workspace/campaigns/<slug>/scripts/<format>-script.md`	A-roll segments, dialogue, shot timing
`workspace/campaigns/<slug>/creators/creator-<name>.md`	Creator energy/vibe reference for motion prompting
`workspace/creators/creator-<name>.md`	Fallback if no campaign-specific profile exists

Writes

File	Notes
`workspace/campaigns/<slug>/clips/a-roll-01.mp4`	One file per A-roll segment
`workspace/campaigns/<slug>/output-log.md`	Motion prompt, model, duration, provider (append-only)

Context loading

🎥 Animate context loaded:
  ✓ First frame: workspace/campaigns/ridge-q1/frames/frame1.png
  ✓ Script: talking-head (A-roll segments: 3)
  ✓ Creator: Maya
  ✓ Campaign: ridge-q1

Contract

Input

Required: approved frame1.png plus a script with [A-ROLL] segments
Optional: creator profile details, alternate prompt file, fallback provider
Format: workspace image and markdown files plus motion prompt text
Source: /first-frame, /persona, and references/motion-prompting.md

Output

Produces: one A-roll clip per [A-ROLL] segment plus append-only generation logs
Format: MP4 files in workspace/campaigns/<slug>/clips/ and rows in output-log.md
Default behavior: use Sora image-to-video with the approved first frame; use text-to-video only as a fallback when no usable frame exists
Downstream use: /b-roll and /assemble

Validation

Pre-conditions: first frame is approved, script is tagged correctly, and the prompt includes the actual dialogue
Post-conditions: local MP4 is saved, creator identity holds, and lip movement/audio feel believable enough to cut into a final video
Failure checks: reroll or adjust the prompt if content filters fail, the hands/face break realism, or the clip is too synthetic to pass downstream

Output

A-roll clips (MP4) in workspace/campaigns/<slug>/clips/
Each clip named a-roll-<segment>.mp4 corresponding to an [A-ROLL] script segment
Generation params logged to workspace/campaigns/<slug>/output-log.md

Next Step

A-roll done → run /b-roll for environment shots, or /assemble if no B-roll needed.

related-skills.json

same repository

scrollclaw-brand-setup.md

from "TheMattBerman/scrollclaw"

One-time brand initialization. Given a brand name and URL, researches the brand and generates the three workspace/brand/ files that the rest of the pipeline reads. Run once per brand before any campaign work.

2026-03-2759

scrollclaw.md

from "TheMattBerman/scrollclaw"

Router and orchestrator for AI UGC video production. Use for broad outcome requests like making a UGC video or running a campaign; it routes step-specific requests to the right sub-skill and can drive the full pipeline from persona research through virality-scored video.

2026-03-2759

scrollclaw-system.md

from "TheMattBerman/scrollclaw"

ScrollClaw system — core doctrine, format selection, pipeline routing, and anti-patterns. Loaded into every UGC conversation.

2026-03-2759

scrollclaw-assemble.md

from "TheMattBerman/scrollclaw"

Assembly stage for UGC videos. Handles stitch mode, post mode, captions mode, or full-assemble mode when the user is explicitly working on finalizing an existing campaign video.

2026-03-2759

scrollclaw-broll.md

from "TheMattBerman/scrollclaw"

Generate B-roll environment and product shots with Kling 3 via fal.ai. Environment matching, cut timing, and visual-only clips that play under continuous voice.

2026-03-2459

scrollclaw-first-frame.md

from "TheMattBerman/scrollclaw"

Generate the canonical first frame with Nano Banana 2. Composition, character, environment, and color — all locked before animation. The visual design gate.

2026-03-2459

package.json

"author": "TheMattBerman"

"repository": "TheMattBerman/scrollclaw"

View GitHub Repository View Creator Repositories

$ install --global

$ download --local

Run Skill in Manus

$ useful --forSOC

Software DevelopersComputer and Mathematical Occupations15-1252L4

name	scrollclaw-animate
description	Animate first frames into A-roll talking head clips. Uses Sora 2 via fal.ai (primary) with Kling 3 auto-fallback when Sora is unavailable or sunset.
metadata	{"openclaw":{"emoji":"🎥","user-invocable":true,"triggers":["animate clip","sora animate","generate clip","a-roll","talking head clip","sora video","kling animate","kling a-roll"]}}

Animate (A-Roll)

Turns first frames into talking head clips with synced lip movement and audio. Image-to-video is the default — text-to-video is the fallback.

Fallback chain: Sora 2 (fal.ai) -> Kling 3 (fal.ai) -> Kling 3 (Replicate). Use --provider kling to skip Sora entirely (for when Sora is sunset).

Prerequisites

First frame approved (from /first-frame)
Script with [A-ROLL] segments tagged (from /persona)

Motion Prompting

Read references/motion-prompting.md for the structured prompt format. Use labeled fields — not prose paragraphs:

Camera — handheld energy, micro-shake, slight reframe
Subject — keep generic (first frame defines appearance). Detailed facial descriptions trigger content safety filters
Dialogue — include actual script lines. Sora generates synced lip movement + audio
Audio — describe the RESULT not the gear. "Clean natural podcast audio, voice close and present, subtle room tone" works. Naming specific mics doesn't.
Environment & light — practical light, deep focus, real-world setting
Style & mood — iPhone selfie-camera realism, not cinematic

Generation

USE THE SCRIPTS. DO NOT construct API calls manually. Scripts handle provider routing, field names, polling, downloading, and error handling.

# Image-to-video (RECOMMENDED — first frame locks the face)
bash scripts/generate-clip.sh \
  --provider fal \
  --image workspace/campaigns/<slug>/frames/frame1.png \
  --prompt-file workspace/campaigns/<slug>/motion-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

# Text-to-video (fallback — no first frame)
bash scripts/generate-clip.sh \
  --provider fal \
  --prompt-file workspace/campaigns/<slug>/scene-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

# Kling direct (skip Sora — use when Sora is sunset)
bash scripts/generate-clip.sh \
  --provider kling \
  --image workspace/campaigns/<slug>/frames/frame1.png \
  --prompt-file workspace/campaigns/<slug>/motion-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

# Replicate Sora (legacy — may stop working when Sora is sunset)
bash scripts/generate-clip.sh \
  --provider replicate \
  --image workspace/campaigns/<slug>/frames/frame1.png \
  --prompt-file workspace/campaigns/<slug>/motion-prompt.txt \
  --output workspace/campaigns/<slug>/clips/a-roll-01.mp4 \
  --log-file workspace/campaigns/<slug>/output-log.md \
  --label a-roll-01 \
  --seconds 8 --aspect-ratio portrait

API Reference

Content Filter Handling

Sora's content filter runs AFTER generation — can fail at 99%. If blocked:

Soften the motion prompt (keep first frame)
Remove any potentially sensitive descriptions
Retry with adjusted prompt
Or use --provider kling — Kling has no content safety filter

Key Findings

Include actual script in Dialogue field — Sora generates synced lip movement
For podcast audio: describe the RESULT, not the gear
Keep Subject descriptions generic — the first frame already defines appearance
fal.ai is primary provider; Kling 3 is auto-fallback when Sora fails or is sunset
Use --provider kling to skip Sora entirely

Brand Memory Integration

Reads

File	Purpose
`workspace/campaigns/<slug>/frames/frame1.png`	Canonical face — fed to Sora i2v to lock creator identity
`workspace/campaigns/<slug>/scripts/<format>-script.md`	A-roll segments, dialogue, shot timing
`workspace/campaigns/<slug>/creators/creator-<name>.md`	Creator energy/vibe reference for motion prompting
`workspace/creators/creator-<name>.md`	Fallback if no campaign-specific profile exists

Writes

File	Notes
`workspace/campaigns/<slug>/clips/a-roll-01.mp4`	One file per A-roll segment
`workspace/campaigns/<slug>/output-log.md`	Motion prompt, model, duration, provider (append-only)

Context loading

🎥 Animate context loaded:
  ✓ First frame: workspace/campaigns/ridge-q1/frames/frame1.png
  ✓ Script: talking-head (A-roll segments: 3)
  ✓ Creator: Maya
  ✓ Campaign: ridge-q1

Contract

Input

Required: approved frame1.png plus a script with [A-ROLL] segments
Optional: creator profile details, alternate prompt file, fallback provider
Format: workspace image and markdown files plus motion prompt text
Source: /first-frame, /persona, and references/motion-prompting.md

Output

Produces: one A-roll clip per [A-ROLL] segment plus append-only generation logs
Format: MP4 files in workspace/campaigns/<slug>/clips/ and rows in output-log.md
Default behavior: use Sora image-to-video with the approved first frame; use text-to-video only as a fallback when no usable frame exists
Downstream use: /b-roll and /assemble

Validation

Pre-conditions: first frame is approved, script is tagged correctly, and the prompt includes the actual dialogue
Post-conditions: local MP4 is saved, creator identity holds, and lip movement/audio feel believable enough to cut into a final video
Failure checks: reroll or adjust the prompt if content filters fail, the hands/face break realism, or the clip is too synthetic to pass downstream

Output

A-roll clips (MP4) in workspace/campaigns/<slug>/clips/
Each clip named a-roll-<segment>.mp4 corresponding to an [A-ROLL] script segment
Generation params logged to workspace/campaigns/<slug>/output-log.md

Next Step

A-roll done → run /b-roll for environment shots, or /assemble if no B-roll needed.

scrollclaw-animate

Animate (A-Roll)

Prerequisites

Motion Prompting

Generation

API Reference

Content Filter Handling

Key Findings

Brand Memory Integration

Reads

Writes

Context loading

Contract

Input

Output

Validation

Output

Next Step

More from this repository

More from this repository

Animate (A-Roll)

Prerequisites

Motion Prompting

Generation

API Reference

Content Filter Handling

Key Findings

Brand Memory Integration

Reads

Writes

Context loading

Contract

Input

Output

Validation

Output

Next Step