🚀 How to Use It
The practical part: what to install (FFmpeg, Hyperframes, Groq, and the optional tools), how to load the .skill in Claude, and the step-by-step interview that generates the your editor and make your first reel. From zero to a working skill.
The stack nests like Russian dolls: the FFmpeg (middle) cuts and renders, the Hyperframes relies on it for motion, and your .skill involves both. External tools (blue) are optional — they’re included only if your profile needs them.
Track map
Detailed content
🚀 Stack and Installation
What to install and why: FFmpeg and Hyperframes (essential), Groq (recommended), the optional tools, and how to load and activate the skill.
The tool that does all the video editing and rendering behind the scenes — it’s the foundation of Remotion, which Hyperframes uses. Without it, nothing runs.
It’s the only truly required item in the core; installation varies a little by operating system.
FFmpeg, rendering, system dependency.
The engine that builds the reel’s animations (motion graphics). It runs via npx, with no heavyweight installation.
It’s the second essential component: without it, there’s no motion. One command confirms it’s running.
Hyperframes, npx, motion graphics.
A free, highly recommended service for transcription and review—in practice, the one that “hallucinates” the least on this task. You just need the key in the environment.
Improves caption accuracy and the reviewer at no cost; checking the environment variable prevents silent errors.
Groq, GROQ_API_KEY, environment variable.
Extras that enable features: fal.ai (AI-generated image, paid), Firecrawl (real B-roll from websites, free) and the /watch (visual QC of the frames).
None are required; you install only what your profile calls for—and nothing paid is added without your “yes.”
fal.ai, Firecrawl, /watch, opt-in.
Load the file .skill in Claude — by double-clicking or via Claude → connectors → skills → load skill. The download is in this track.
It’s the step that makes the meta-skill available for you to talk to.
.skill file, connectors, load skill.
Once loaded, you call the meta-skill by typing "Forja Reel" in Claude — preferably with the model Opus, not Sonnet.
The stronger model guides the interview better and makes more consistent identity decisions.
Activation, Opus, interview.
🧩 Interview, Generate Your Skill, and Make Your First Reel
The 8-block interview, one decision at a time, the opt-in diagnosis, generating the child skill, and the command that runs your first reel.
A conversation in 8 blocks: what you edit, how you appear, visual identity, pacing, B-roll, text, delivery, and control.
These answers become your half (the identity) of the child skill.
Interview, 8 blocks, identity.
The skill asks one question at a time, in clear language, and always suggests a recommendation. At the end, everything becomes a perfil.json.
You make decisions without losing your way, even if you don’t know the jargon; or you can simply accept the suggested default.
Guided decision, recommendation, perfil.json.
The skill checks what’s already on your machine and installs only what your profile needs — nothing paid without your approval.
Prevents unnecessary installs and keeps you in control of what gets added.
Diagnostics, opt-in, minimal dependencies.
The skill copies the engine and combines it with your generated identity, creating a new skill: reel-edita-<marca>. It's your editor.
Here the meta-skill does its job—building an editor that looks like you.
Child skill, engine + identity, generation.
With the child skill ready, you call reel edita <caminho do MP4> and the engine does the rest — editing, assembly, captions, SFX, review.
It’s the command that closes the loop: from raw footage to a finished reel, in your style.
reel edits, file path, first render.
If an optional component is missing, the engine doesn't stall: without fal.ai, the cold open comes out without an AI image; without Firecrawl, it uses another supporting element. It always delivers something.
You can start with just the essentials and turn on the extras later, without worrying about breaking anything.
Graceful degradation, fallback, essentials first.