# Reeljet

> Use when the user wants to create a short promo or demo video (Reels/TikTok/Shorts/landing hero) for an app, web, or SaaS from their own screen recordings and screenshots. Orchestrates creative direction, Higgsfield-generated motion/b-roll, local music, and deterministic ffmpeg assembly into master 16:9 + 9:16. Trigger: /reeljet.

- **Type:** Skill
- **Install:** `agentstack add skill-xabilimon1-reeljet-reeljet`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Xabilimon1](https://agentstack.voostack.com/s/xabilimon1)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Xabilimon1](https://github.com/Xabilimon1)
- **Source:** https://github.com/Xabilimon1/reeljet

## Install

```sh
agentstack add skill-xabilimon1-reeljet-reeljet
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# reeljet

Turn real product captures into short promo videos. You provide the substance
(recordings, screenshots, logo); Higgsfield adds motion/b-roll; a local library
adds music; ffmpeg assembles the final cut.

## Prerequisites
- ffmpeg installed (`brew install ffmpeg`).
- `~/reeljet/music-library/` populated (see references/music-selection.md).
- Higgsfield MCP connected with credits.

## Workflow (5 phases)

### Phase 0 — Intake + brand
1. Get the asset folder (recordings, screenshots, logo) + a short brief
   (what it does, audience, USP, tone, CTA).
2. Create the campaign dir:
   `~/reeljet/ads//-/`.
3. `python3 scripts/extract_palette.py --assets  --out /palette.json`
4. `python3 scripts/extract_frames.py --video  --out /frames`

### Phase 1 — Creative plan  (APPROVAL GATE)
Read references/creative-direction.md. Write `/plan.json` (validated by
scripts/lib/plan_schema.py) and a human `/plan.md` storyboard.
Pick music: `python3 scripts/pick_music.py --mood ... --bpm ... --keywords ...`.
Set shot durations to whole beats (60/bpm). Compute and show the **estimated
Higgsfield credit cost** (sum per generated shot, see references/higgsfield-tools.md).
**STOP. Present plan.md + cost. Do not generate until the user approves.**

### Phase 2 — Generation (Higgsfield)
For each shot with source `higgsfield_broll` or `animated_screenshot`, call the
MCP tool per references/higgsfield-tools.md. Skip shots already `status: done`
(idempotent — never re-spend credits). Download into `/generated/`,
set `output_path`, `status`, `cost` in plan.json. Normalize every clip to
1920x1080@30 (references/ffmpeg-recipes.md) before assembly.

### Phase 3 — Assembly (ffmpeg)
`python3 scripts/assemble.py --campaign-dir `
Produces `master_16x9.mp4` and reframed `master_9x16.mp4`, captions burned from
palette, music mixed at -14 LUFS. Append the logo end-card/CTA.

### Phase 4 — QA / iterate
Check: hook readable in 2s; captions in mobile safe margins; audio -14 LUFS;
duration within platform limits; H.264/AAC. To redo one shot, clear its
plan.json entry (status->pending, drop output_path) and re-run Phase 2 + 3.

## References
- references/creative-direction.md — hooks, arc, caption style.
- references/higgsfield-tools.md — exact MCP tools, presets, models, cost.
- references/ffmpeg-recipes.md — normalization, master, reframe, end-card.
- references/music-selection.md — library, brief->track, BPM grid.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Xabilimon1](https://github.com/Xabilimon1)
- **Source:** [Xabilimon1/reeljet](https://github.com/Xabilimon1/reeljet)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xabilimon1-reeljet-reeljet
- Seller: https://agentstack.voostack.com/s/xabilimon1
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.