Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions directory/skills/raea/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,7 @@ task needs.
|---|---|
| a cut of real footage: takes cut by words, faces framed, captions, cuts to a song | [footage.md](footage.md) |
| motion graphics and type: cards, stats, logos, end cards | [graphics.md](graphics.md) |
| a short product film (a launch, a demo, a brand film) made like a good film of its kind, or one you were handed ("make me one like this") | the video-decompiler skill, installed beside this one by raea's installer and plugin (not in the plugin directory's edition) |
| sound: voice, beds, foley, music for picture, the mix | [sound.md](sound.md) |
| a 3D scene: lights, materials, models, people, rooms, splats; three.js or React Three Fiber work | [3d.md](3d.md) |
| a game, 2D or 3D | [games.md](games.md) |
Expand Down
32 changes: 25 additions & 7 deletions directory/skills/raea/motion/delivery.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,23 @@
- Publishing is the person's. The app's Publish view sends a post to a network, now or at a time, after checking it
against that network's guidelines; nothing goes out until they press Publish or Schedule. Have the file, its tags
and, when asked, a caption within the network's limit ready for them.
- When the person finishes the cut in an editor, hand it over in layers: `raea export capcut EDIT.tsx` writes the
composition as a CapCut draft, its footage and sounds as clips of their own files at their trims and gains and
everything raea draws as transparent clips over them, entered in CapCut's project list (CapCut must be closed;
`-o DIR` writes the draft folder anywhere). In the raea app it's Export to, then CapCut, on the render's card, or To
CapCut on its page. Pass on what the export notes: a clip that moves or fades within its shot lands as its first
frame shows it, and a Tone graph's music has no file to place.
- When the person finishes the cut in an editor, hand it over in layers. For CapCut, `raea export capcut EDIT.tsx`
writes a draft entered in CapCut's project list (CapCut must be closed; `-o DIR` writes the draft folder anywhere);
in the raea app it's Export to, then CapCut, on the render's card, or To CapCut on its page. For Premiere Pro and
DaVinci Resolve, `raea export xml EDIT.tsx` writes out/xml/NAME with an XML for each: NAME.premiere.xml (Premiere:
File, Import) and NAME.resolve.xml (Resolve: File, Import, Timeline).
- In each, the footage and sounds are clips of their own files at their trims and gains (the XML points at them
where they are; the CapCut draft copies them in), placed, cropped and keyframed as the composition moves and fades
them; everything raea draws is transparent clips, the graphics over the footage and what's under it (a background
holding footage, the 3D) below; captions are a track of their own, styled as drawn, with their words as an .srt
beside them. Each export also puts reference.mp4, the composition as raea renders it, in its folder, to set beside
the editor's timeline.
- The editor gets captions and graphics as pictures. Mark captions so they're their own track (`motion/words`), and
fix a word in raea and export again: retyped in the editor, it no longer matches the picture.
- Pass on what the export notes. CapCut can't animate a crop: footage whose cut changes over its clip (a split
screen's seam moving) is cut there as its first frame shows it, its moves and fades keyed. Premiere and Resolve get
a clip at another speed at its own speed, and a sound's fades to set by hand; Resolve's footage is placed for its
default Input Scaling (Scale entire image to fit). A Tone graph's music has no file to place.
- Graphics for someone else's edit (a lower third, a title, a logo sting) go out as a transparent movie:
`raea render gfx.tsx -o out/lower-third.mov --alpha` (ProRes 4444 on a Mac, QuickTime Animation elsewhere;
`--alpha-codec hevc` for a far smaller file, on a Mac). Draw nothing behind them: no full-frame fill, no background.
Expand All @@ -50,7 +61,9 @@ its hook in another. The numbers that decide this (shapes, lengths, file sizes,
are the app's own publishing guidelines, generated into reference/platforms.md, so a delivery made to them is one
Publish accepts without a fix. Tags with the same keys across a project are what make the Table a delivery list
rather than a pile of files. An editor finishing the cut needs layers, not a flattened picture: a draft with the
footage as clips and raea's drawing over them keeps every cut and title editable, where an .mp4 bakes them in.
footage as clips and raea's drawing over them keeps every cut and title editable, where an .mp4 bakes them in. The
two XMLs differ only where Premiere and Resolve read the same FCP7 XML differently (each was checked against its own
exports and renders), so one file can't be right in both.

## Common mistakes

Expand All @@ -66,6 +79,11 @@ footage as clips and raea's drawing over them keeps every cut and title editable
- A transparent movie with a full-frame background, which covers the footage it's laid on; or `--alpha` with an
.mp4, which holds no alpha (raea refuses it: use .mov).
- Exporting to CapCut while CapCut is open. It rewrites its project list when it quits, so raea refuses: quit it first.
- Captions not marked `data-raea-role="caption"`: the layered export can't tell them from the graphics, so they
arrive inside the graphics track with no .srt.
- A caption or a title retyped in the editor. It's a picture there: fix it in raea and export again.
- NAME.premiere.xml imported into Resolve, or NAME.resolve.xml into Premiere. Each editor reads FCP7 XML's crop,
scale and position its own way, so each gets its own file.

## Example: one piece in the three shapes it ships in

Expand Down
5 changes: 4 additions & 1 deletion directory/skills/raea/motion/words.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,9 @@
- Size captions at 60 px or more at 1080 wide (scale with the width), with at least 3:1 contrast against the pixels
behind them. Keep them in one place unless a move means something, and keep them off cards, logos, burned-in text
and the face (`motion/placement`).
- Mark each caption: `data-raea-role="caption"` on the element holding its words. A layered export (`raea export
capcut`, `raea export xml`; `motion/delivery`) then puts the captions on a track of their own, styled as they're
drawn, and writes their words as an .srt beside them; unmarked, they're part of the graphics.
- The transcript reaches the render for you: `raea cut` writes words.json beside the edit, and `raea render` reads it
from there. Give it to `raea check` with `--words words.json`, so the check can match cues to their words.

Expand Down Expand Up @@ -76,7 +79,7 @@ function Captions() {
const g = groups[i];
const local = f - g[0].from;
return (
<div style={{
<div data-raea-role="caption" style={{
width: "100%", textAlign: "center", fontFamily: "var(--brand-font-heading)", fontWeight: 800, fontSize: 84, lineHeight: 1,
color: "var(--brand-text)", textShadow: "0 4px 24px rgba(0,0,0,0.5)",
transform: `translateY(${interpolate(local, [0, 5], [24, 0], { ...clamp, easing: OUT })}px)`,
Expand Down
4 changes: 3 additions & 1 deletion directory/skills/raea/reference/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -482,7 +482,9 @@ Flags: `--icon` (1), `--keys` (1), `--name` (1), `--no-strip`, `--player` (1), `
Access: HEADLESS. Arguments besides flags: 2.

```
raea export capcut EDIT.tsx [--composition ID] [-o DIR] [--name NAME] [--alpha-codec prores|hevc|rle|png] [--no-register] (the composition as a CapCut draft ready in its timeline: its footage and sounds as clips of their own files at their trims and gains, everything raea draws as transparent overlay clips above them; into CapCut's projects, entered in its project list while CapCut is closed, or a draft folder in DIR; the reference render and the overlay movie kept in out/capcut/NAME)
raea export capcut EDIT.tsx [--composition ID] [-o DIR] [--name NAME] [--alpha-codec prores|hevc|rle|png] [--no-register] (the composition as a CapCut draft ready in its timeline: its footage and sounds as clips of their own files at their trims and gains, everything raea draws as transparent overlay clips above them; the captions on a track of their own above it; into CapCut's projects, entered in its project list while CapCut is closed, or a draft folder in DIR; the reference render copied into the draft's folder, and it and the layers kept in out/capcut/NAME)
raea export layers EDIT.tsx [--composition ID] [-o DIR] [--name NAME] [--alpha-codec prores|hevc|rle|png] (the composition as its layers and the timeline that places them, layers.json: the captions and the graphics as transparent movies, what's under the footage (and any 3D) as an opaque one, the footage and sounds as clips of their own files where they are, the captions also as SubRip, and the reference render; into out/layers/NAME, or DIR)
raea export xml EDIT.tsx [--composition ID] [-o DIR] [--name NAME] [--alpha-codec prores|hevc|rle|png] (the composition as an FCP7 XML project for Premiere Pro (File, Import) and DaVinci Resolve (File, Import, Timeline): its layers as raea export layers writes them, NAME.premiere.xml and NAME.resolve.xml beside them placing them on a timeline, each as that editor writes it, the footage and sounds as clips of their own files where they are, each clip's own sound linked to it; into out/xml/NAME, or DIR)
```

Flags: `--alpha-codec` (1), `--composition` (1), `--name` (1), `--no-register`, `-o` (1).
Expand Down
4 changes: 2 additions & 2 deletions skills/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "raea",
"displayName": "raea",
"description": "Make video, motion graphics, games and 3D scenes with raea, the Render Anything Engine: the raea skill, and hooks that run raea's quick check on a composition after it's saved and show media in the raea app instead of the Mac's viewer.",
"description": "Make video, motion graphics, games and 3D scenes with raea, the Render Anything Engine: the raea skill, the video-decompiler skill (a short product film made from a good film of its kind, by James Dimachkie), and hooks that run raea's quick check on a composition after it's saved and show media in the raea app instead of the Mac's viewer.",
"author": {
"name": "raea",
"url": "https://raea.io"
Expand All @@ -15,5 +15,5 @@
"supportUrl": "https://github.com/shinyobjectz/raea-skills/issues",
"privacyPolicyUrl": "https://raea.io/privacy/",
"termsOfServiceUrl": "https://raea.io/terms/",
"skills": ["./raea"]
"skills": ["./raea", "./video-decompiler"]
}
13 changes: 11 additions & 2 deletions skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ a game, or renders single frames to check. This plugin teaches Claude to use rae
kind of work needs: footage cut by its words, motion graphics and type, sound and music, 3D scenes (Bevy materials,
lights, physics, Gaussian splats), games, app interfaces, generated media, and delivery. Its `reference/` files are
generated from raea's code, so they list the real verbs, flags and SDK imports.
- **The video-decompiler skill** (`video-decompiler/`), by James Dimachkie, MIT. It makes a short product film (a
launch film, a demo, a brand film) as raea code: take a good film of its kind apart, write yours on one page, build
picture and sound on one clock, have it read blind, then show a person. Its tools are Python, in an environment of
their own; `video-decompiler/UPSTREAM.md` says where it comes from, what it runs and how it's updated.
- **Two hooks** (`hooks/`), for Claude Code and Cowork. Before Claude runs a shell command, a command that opens a
still, a video or a sound in the Mac's viewer is stopped once and Claude is told to use `raea show`, which puts it in
the raea app where you can answer it; the same command again goes through. This happens only while the raea app is
Expand Down Expand Up @@ -59,7 +63,10 @@ The plugin itself sends nothing anywhere and stores nothing. Its hook script (`h
saved file, and keeps a small marker under `~/.raea/hooks` so a command it stopped goes through when tried again. It
reads `~/.claude/settings.json` only to see whether raea's hooks are already there.

The skill tells Claude to run the `raea` command, which works on your computer. A few of raea's verbs reach the
The video-decompiler skill's tools run on your computer too (Python, `ffmpeg`, `ffprobe` and `raea`) and reach no
network; they write under `~/.vd` and in the film's folder (`video-decompiler/UPSTREAM.md`).

The raea skill tells Claude to run the `raea` command, which works on your computer. A few of raea's verbs reach the
network when you ask for them: the installer downloads raea from raea.io, `raea gen` calls the generation providers you
set up with your own keys (and spends your money there, so the skill has Claude quote the cost first), and a review
link made in the raea app uploads the cut you choose to share. raea's privacy policy is at https://raea.io/privacy/.
Expand All @@ -68,5 +75,7 @@ link made in the raea app uploads the cut you choose to share. raea's privacy po

This folder is the `skills/` folder of
[shinyobjectz/raea-skills](https://github.com/shinyobjectz/raea-skills), where the skill is written and checked.
Apache-2.0; the copied guides keep their notices (`raea/3d/NOTICE`, `raea/craft/NOTICE`). Questions and bugs:
Apache-2.0; the copied guides keep their notices (`raea/3d/NOTICE`, `raea/craft/NOTICE`). `video-decompiler/` is MIT,
copied from [JimGHTB12/video-decompiler](https://github.com/JimGHTB12/video-decompiler) with its `LICENSE` and
`NOTICE`; the fonts, pictures and sounds in its `library/` keep their own licences, listed there. Questions and bugs:
[issues](https://github.com/shinyobjectz/raea-skills/issues).
1 change: 1 addition & 0 deletions skills/raea/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,7 @@ task needs.
|---|---|
| a cut of real footage: takes cut by words, faces framed, captions, cuts to a song | [footage.md](footage.md) |
| motion graphics and type: cards, stats, logos, end cards | [graphics.md](graphics.md) |
| a short product film (a launch, a demo, a brand film) made like a good film of its kind, or one you were handed ("make me one like this") | the video-decompiler skill, installed beside this one by raea's installer and plugin (not in the plugin directory's edition) |
| sound: voice, beds, foley, music for picture, the mix | [sound.md](sound.md) |
| a 3D scene: lights, materials, models, people, rooms, splats; three.js or React Three Fiber work | [3d.md](3d.md) |
| a game, 2D or 3D | [games.md](games.md) |
Expand Down
Loading
Loading