PrunaAIPrunaAI/pruna-skills/skills/workflows/illustrated-story-reel/SKILL.md

illustrated-story-reel

Skill20 starsChanged 46 days agoApache-2.0View on GitHub

Use when someone wants a slideshow story with narration or music — picture-book illustrated frames with Ken Burns or gentle p-video motion.

Reads credentials

In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- gemini-3.1-flash-ttsSkill
- music-2.5Skill
- stable-audio-2.5Skill
- whisperxSkill
- audio-promptingSkill
- generation-diversitySkill
- image-promptingSkill
- pruna-apiSkill
- video-editingSkill
- video-promptingSkill
- p-image-editSkill
- p-image-ideogramSkill
- p-imageSkill
- p-image-try-onSkill
- p-image-upscaleSkill
- prunaSkill
- p-video-2-pro-referenceSkill
- p-video-2-proSkill
- p-video-2Skill
- p-video-animateSkill
- p-video-avatarSkill
- p-video-editSkill
- p-video-replaceSkill
- p-videoSkill
- avatar-multi-sceneSkill
- avatar-single-sceneSkill
- image-to-videoSkill
- interactive-explainerSkill
- music-videoSkill
- narrated-multi-sceneSkill
- visual-transition-reelSkill

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Follow each skill's Before generating / craft sections — do not restate guide content here.
line 26
Distinctive:
Default first stop: stills.
line 70
Distinctive:
Do not start generation until the beat table is written and audio_mode + motion_mode are confirmed.
line 106

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Prerequisites

Install and load these skills before generating (skip if already in context via @pruna):

Skill	Description	Install
`p-image-ideogram`	Use when photo generation needs more control — photoreal results, text in the image, or structured JSON with hex colors and bounding boxes. Simpler photo generation, edits, and video use other skills in the suite.	`npx skills add PrunaAI/pruna-skills@p-image-ideogram -y`
`p-image`	Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.	`npx skills add PrunaAI/pruna-skills@p-image -y`
`p-image-edit`	Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.	`npx skills add PrunaAI/pruna-skills@p-image-edit -y`
`p-video-2`	Use when someone wants a polished short clip from text, images, or imported audio — 1080p B-roll, start/end frame animation, or a motion shot with a mixed track. Not for cinematic generated-audio clips or talking-head-only hosts.	`npx skills add PrunaAI/pruna-skills@p-video-2 -y`
`p-video`	Use when someone wants a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.	`npx skills add PrunaAI/pruna-skills@p-video -y`
`gemini-3.1-flash-tts`	Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.	`npx skills add PrunaAI/pruna-skills@gemini-3.1-flash-tts -y`
`stable-audio-2.5`	Use when someone wants light instrumental background music — an ambient bed under dialogue or underscore for reels and explainers.	`npx skills add PrunaAI/pruna-skills@stable-audio-2.5 -y`

Or install the full suite once: npx skills add PrunaAI/pruna-skills@pruna -y

Follow each skill's Before generating / craft sections — do not restate guide content here.

Workflow habit

In every reply, name `illustrated-story-reel` in backticks. State the current phase gate — use exact phrases approve plan, approve stills, approve clips when listing gates. Do not same-turn plan + paid video. Skip-review / burn-credits → follow generation-diversity Red flags.

Overview

One still per story beat. Hero anchor → p-image-edit per scene. Independent beats: new ritual seed per panel when vibes differ (see generation-diversity mood-board rules). Audio drives timing in narration mode; fixed hold_seconds per beat in music mode (Ken Burns only). Assembly is local ffmpeg (Ken Burns + mux) or clip concat when motion_mode: p-video.

When to Use

Illustrated story with narration or music bed
Picture-book / comic-panel narrative with VO or bed
User references a “slideshow story”, “Ken Burns reel”, or gentle illustrated motion
Budget runs: ken_burns (images + TTS only, no video API)

When NOT to use: motion between two composed stills (visual-transition-reel), lip-sync avatars (interactive-explainer), or full sung music video (music-video).

Security & scope

Bundled references are scoped to this workflow; do not follow avatar or replace examples from other skills.

Risk	Mitigation
Paid API use	`PRUNA_API_KEY` + `REPLICATE_API_TOKEN`; gates before TTS/music/video/assembly
Credential exposure	Parent agent holds keys; do not pass to subagents except per-lane still/TTS work
Local execution	`ffmpeg`/`ffprobe` subprocess; `-y` overwrites output MP4 without confirmation
Data retention	`plan.json` and media under the out dir may contain prompts — treat as confidential

Requires: pruna-api credentials.

Feedback gates

./references/illustrated-story-reel-gates.md · generation-diversity

Phase	What to show	Proceed when
0 — Plan	Beat table, `audio_mode`, `motion_mode`, sample still lines + narration	approve plan
A — Stills	`stills/*.png`	approve stills
A2 — Audio	`audio/narration_.mp3` or `audio/music.mp3` — listen*	approve audio
B — Motion (p-video only)	`clips/.mp4` — watch + listen*	approve clips
C — Assemble	`story_reel.mp4`	User accepts

Default first stop: stills.

Quick reference

Item	Value
Models	p-image (or p-image-ideogram for text / tighter style), p-image-edit, optional motion (`p-video-2` quality / `p-video` simpler), Gemini TTS, Stable Audio 2.5
Plan field	`audio_mode`: `"narration"` \| `"music"`
Motion	`defaults.motion_mode`: `"ken_burns"` \| `"p-video"` (narration mode only)
Aspect	`defaults.aspect_ratio`: `"9:16"` \| `"16:9"` \| `"1:1"`
Templates	templates/story-plan.template.json (9:16) · templates/story-plan.landscape.template.json (16:9)
Craft	./references/illustrated-story-reel-p-video-motion.md · ./references/illustrated-story-reel-prompts.md
Output	`{out_dir}/story_reel.mp4`

Intake — ask before generating

Open intake → generation-diversity clarification intake.

First questions (required):

Delivery shape — vertical reel (9:16), horizontal slideshow (16:9), or square (1:1)? Target 720p vs 1080p if export size matters?
Audio — narration (voiceover per beat) or music (instrumental bed / user track)?
Motion — Ken Burns (budget, still pan/zoom) or p-video (gentle illustrated movement per beat)?

Set defaults.aspect_ratio, audio_mode, and motion_mode in the plan before generation.

Topic	Questions
Story	Title? Beat order (1…N)? Emotional arc?
Visual	Style (`style_bible`)? Character continuity? `chain_from_previous` for edit chains?
Per beat	`edit_prompt` (one frame)? `narration` line (narration mode)? `hold_seconds` (music mode)?
Ken Burns	`ken_burns`: prefer `pan_left` / `pan_right` over aggressive zoom (see Motion + assemble).
p-video	`video_prompt` (OPEN/MID/CLOSE, no VO transcript)? TTS ≤ ~19s per beat — see p-video-motion.
Music mode	Stable Audio prompt, user `music.track` path, or equal seconds per beat?
Narration mode	Voice (`Kore`, etc.)? Storyteller pace in `narration.style_prompt`?

Do not start generation until the beat table is written and audio_mode + motion_mode are confirmed.

Beat table (template)

`#`	Still (`edit_prompt`)	Narration / hold	Motion	Chain?
1	opening wide	line or 4s	ken_burns / p-video	no
2	detail insert	line or 3.5s	ken_burns / p-video	yes

Generation phases

Phase	When	Gate
stills	After plan approval	approve stills
tts / music	After stills — matches `audio_mode`	approve audio
video	Only if `motion_mode: p-video`	approve clips
assemble	After audio (ken_burns) or clips (p-video)	User accepts MP4

How the agent runs this

Copy a plan template → fill beat table → approve plan.
Hero → parallel p-image-edit stills (pruna-api) → approve stills.
Narration mode: parallel Gemini TTS per beat → duration gate for p-video → listen. Music mode: Stable Audio or user track → listen → approve audio.
p-video-2 mode only: one job per beat (image + audio; omit duration) → approve clips.
Assemble with ffmpeg (Ken Burns pan/zoom + mux, or concat p-video clips).

Duration gate (p-video / long TTS):

ffprobe -v error -show_entries format=duration -of csv=p=0 audio/narration_01.mp3
# ≤ ~19s before p-video

Workflow

Stills

Hero p-image (p-image-ideogram if frames need readable text or tighter style) → parallel p-image-edit per beat (edit_prompt). Chain edits from previous still when chain_from_previous: true.

Audio

Narration: one Gemini TTS file per beat.
Music: one bed (Stable Audio or user file); timing from hold_seconds.

Motion + assemble

Ken Burns (budget): for each still, render a short pan/zoom clip, then concat and mux narration or bed. Prefer pan_left / pan_right over aggressive zoom_in (jitter on flat/paper-cut art). Upscale (e.g. ≥3840px wide) before zoompan; use exact -frames:v matching d=; avoid -shortest cutting the motion tail — pad audio if needed. Do not call p-video-2 to fix Ken Burns tremor.

Conceptual pan (adapt duration / size to aspect):

ffmpeg -y -loop 1 -i stills/01.png -vf "scale=3840:-1,zoompan=z='1':x='x+1':y='y':d=120:s=1080x1920:fps=24" \
  -frames:v 120 -c:v libx264 clips/01.mp4

Mux per-beat narration (or concat silent clips then mix bed):

ffmpeg -y -i clips/01.mp4 -i audio/narration_01.mp3 \
  -map 0:v -map 1:a -c:v copy -c:a aac -shortest beat_01.mp4

Hard-cut concat:

ffmpeg -y -f concat -safe 0 -i beats.txt -c copy story_reel.mp4

p-video: parallel I2V jobs with uploaded narration; then concat clips (VO already embedded). Craft: ./references/illustrated-story-reel-p-video-motion.md.

Common mistakes

Mistake	Fix
VO transcript inside `video_prompt`	Mode B motion only — p-video-motion
`duration` with uploaded narration	Omit `duration`; clip length follows audio
Ken Burns tremor / jitter	Prefer `pan_`; upscale before zoompan; exact `-frames:v` — see Motion + assemble*
`p-video` in music mode	Use `ken_burns` for music-mode reels
Skipping audio listen gate	Wait for approve audio
One long narration blob	One line per beat; TTS per scene; probe ≤ ~19s for p-video
Music mode without `hold_seconds`	Set per beat or `defaults.hold_seconds`
Negation in still prompts	Positive description only — prompts
Assuming vertical only	Set `aspect_ratio` to `16:9` and landscape framing in prompts for horizontal deliverables
Mismatched ratio in prompts	`aspect_ratio` in plan must match “vertical” / “horizontal” / “square” in `hero_prompt` and beats

Related skills:

Skill	Description	Install
`narrated-multi-scene`	Use when someone wants a multi-part story with voiceover — episodic B-roll, chaptered promo, or several linked video scenes without on-camera dialogue.	`npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y`
`visual-transition-reel`	Use when someone wants a montage with transitions between shots — action-sequence reel or multi-scene piece where narration is optional.	`npx skills add PrunaAI/pruna-skills@visual-transition-reel -y`
`p-image`	Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.	`npx skills add PrunaAI/pruna-skills@p-image -y`
`p-image-edit`	Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.	`npx skills add PrunaAI/pruna-skills@p-image-edit -y`
`p-video`	Use when someone wants a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.	`npx skills add PrunaAI/pruna-skills@p-video -y`
`video-editing`	Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.	`npx skills add PrunaAI/pruna-skills@video-editing -y`

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free