Shellbot Product Video

Overview

Build one thing well: product marketing videos that convert. Keep Remotion as the source of truth for pacing, layout, animation, and render output. Use external generation tools only to enrich scenes. Built by the [ShellBot Team](https://getshell.ai).

Non-Negotiable Story Structure (AIDA)

Follow this structure in order:

1. Establish the problem being solved.
2. Introduce the solution.
3. Show use cases, not feature lists.
4. End with a CTA that includes an incentive.

Reject drafts that skip any step.

Workflow

1) Bootstrap the Remotion Base Project

List bundled templates:

./scripts/bootstrap_template.sh --list

Bootstrap the chosen template:

./scripts/bootstrap_template.sh --template cinematic-product-16x9 ./my-product-video
cd ./my-product-video
npm install

To also copy official Remotion rule asset snippets into the project:

./scripts/bootstrap_template.sh --template cinematic-product-16x9 --include-rule-assets ./my-product-video

Template bundle:

1. assets/remotion-product-template (aida-classic-16x9)
2. assets/templates/cinematic-product-16x9
3. assets/templates/saas-metrics-16x9
4. assets/templates/mobile-ugc-9x16
5. references/remotion-rules/assets (official-style reusable snippet assets)

Then adapt scene content/components and composition metadata in src/Root.tsx for the brief.

2) Capture Brief Inputs

Collect these fields before writing scenes:

1. Product name
2. Audience
3. Core pain/problem
4. Value proposition (one sentence)
5. 2 to 4 use cases
6. CTA
7. Incentive for CTA (discount, trial extension, bonus, etc.)
8. Visual style direction

If use cases are missing and only features are present, ask for use-case phrasing.

3) Build AIDA Narrative and Timing

Use this duration allocation as a starting point:

1. Attention: 0% to 20%
2. Interest: 20% to 45%
3. Desire: 45% to 80%
4. Action: 80% to 100%

Generate a structured plan with:

python3 scripts/brief_to_aida_plan.py --in brief.json --out plan.json --duration-sec 45 --fps 30

4) Map Story to Remotion Scenes

Implement scenes as React components and sequence them using Sequence. Keep transitions purposeful and short (usually 8-18 frames).

Load [references/remotion-product-video-playbook.md](references/remotion-product-video-playbook.md) when writing or reviewing Remotion code. Load [references/remotion-rules-index.md](references/remotion-rules-index.md) and then only the specific files needed from references/remotion-rules/.

5) Add Ancillary Assets (Optional but Useful)

Use Freepik-generated assets only to support scenes:

1. Nano Banana 2 or Freepik image models for hero stills/background art.
2. Kling for short inserts or transition clips.
3. ElevenLabs voiceover and music endpoints for narration and soundtrack.

Do not let generated clips replace the whole narrative structure.

Load [references/freepik-ancillary-assets.md](references/freepik-ancillary-assets.md) when planning asset generation.

6) Assemble, QA, and Render

Run this QA gate before rendering:

1. Problem is clear in first 3-5 seconds.
2. Solution is introduced before midpoint.
3. Use cases are concrete scenarios, not feature bullets.
4. CTA includes an explicit incentive.
5. Audio levels keep voiceover intelligible over music.

Then render via Remotion CLI or renderer API.

Creative Rules

1. Prefer visual metaphors and outcomes over UI tours.
2. Keep one message per scene.
3. Use motion to direct attention, not decorate.
4. Show benefits in context: who uses the product, when, and what changes.
5. Keep CTA simple and singular.

Deliverables

Produce these outputs for each request:

1. AIDA script draft.
2. Scene plan JSON (plan.json).
3. Remotion project from the selected bundled template customized for the brief.
4. Asset manifest listing generated inputs and their intended scene usage.
5. Final render command(s).

References

1. Remotion implementation details: [references/remotion-product-video-playbook.md](references/remotion-product-video-playbook.md)
2. Remotion rules navigator: [references/remotion-rules-index.md](references/remotion-rules-index.md)
3. Freepik ancillary generation recipes: [references/freepik-ancillary-assets.md](references/freepik-ancillary-assets.md)
4. Template chooser: [references/template-showcase.md](references/template-showcase.md)
5. Packaging and publishing: [references/publishing-clawhub.md](references/publishing-clawhub.md)
6. ShellBot Team: [getshell.ai](https://getshell.ai)

Use this skill for product marketing videos only. For other video categories, use a different skill.