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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions skills/raea/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -270,6 +270,16 @@ least sure of. Once they've answered, `--tally` makes the answers evidence.
next tool call and keeps your turn from ending until you have it (where there is no hook, follow the file with
`tail -n0 -F FILE` or your harness's monitor). Answer each: it may change what you're doing. Without the app,
`raea show` opens the file in the Mac's own viewer and says so; take the person's notes as text then.
- When one picture holds several things (a contact sheet, a side by side, a before and after, a grid of props or
characters), label each instead of naming them by position in the title or your message. A label is a tag of a few
words that stands beside the picture, never on it, and points at its place when the person's pointer is on it; give
it a paragraph only where a tag isn't enough. In the app, `feed_post` takes `labels`: each `{ text, detail?, box:
[x0, y0, x1, y1] }` or `point: [x, y]` in the picture's own 0-1, with `frame` for a storyboard's still, `t` (and
`to`) for a film's seconds, or `part` for a scene's part. Outside it: `raea show sheet.png --label "0,0,.5,1 v1, hook
first" --label ".5,0,1,1 v2, product first" --detail "Opens on the product for two seconds, then the hook."` (each
`--label` is the place, then its tag; a `--detail` is the paragraph of the `--label` before it). A sheet `raea media
sheet` made comes labelled with each cell's time or file; to say more, edit the tags and paragraphs in its
`OUT.labels.json` before you show it.
- When you need the person to choose or fill something in (pick an opening, rank cuts, set a price), post an artifact:
a React `.tsx` of your own, `feed_post` with `type: "artifact"`, the file, and an `ask` line. The app builds it and
runs it sandboxed in the feed. Its default export is the component. It imports `react`, `@raea/app` and its own
Expand Down
5 changes: 3 additions & 2 deletions skills/raea/reference/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ Access: HEADLESS. Its arguments go to a parser of its own: `raea media` alone li

```
raea media probe|still|sheet|audio|loudness|motion|cuts|freezes|proxy|lod|trim|concat FILE ... | ffmpeg ARGS | ffprobe ARGS (media work, native: media help)
raea show FILE... [--title T] [--ask LINE] [--project P] [--replaces ITEM] [--as NAME] [--role ROLE] [--inbox NAME] [--open] [--label LABEL] [--detail PARAGRAPH] [--labels FILE.json] | raea show --question Q --choice A --choice B [STILL...] | raea show [--title T] --question Q [--preview FILE] --choice A [--preview FILE] --choice B ... [--question Q2] ... | raea show --on ITEM [--working ID] [--ask TEXT] [--status S] [--states S1,S2] [--sign N --clip FILE --render HASH] [--done ID] [--note LINE] [--sub NAME] (shown in the raea app as an item the person can use and answer, posted quietly with a notice, the window left where they are unless --open: stills (several, a storyboard), a video, a sound, a NAME.script.ts or .md, a .tsx (an interactive artifact; a project's composition opens in its editor), or questions, all of them one item; --label "PLACE TAG" a label beside the picture, never on it, that points at PLACE (x0,y0,x1,y1 or x,y in its 0-1, then #N the Nth file, @T or @T-TO a film's seconds, or part=KEY a scene's part; the tag the rest), --detail the paragraph of the --label before it, --labels a JSON list of them as feed_post takes them, and a sheet raea media sheet made comes labelled; each question and choice with a --preview to play or read while answering (a still, a video, a sound, a script or .md; after a --choice that choice's, else the question's); what they send comes to ~/.raea/inbox/INBOX.jsonl; their edit comments are tasks: --working ID as you start one (each --ask with it one ask you read it as, for the person to correct; --status and --states where the note and each ask stand: to restate, to check, failing, to sign, passing, signed; --sign N --clip FILE --render HASH a clip under ask N for them to sign; a note closes when they retire it, never with --done), --done ID when it's settled, or with the version that settles it, FILE --replaces ITEM --done ID; never open media in Preview while the app is installed)
```

## raea bundle
Expand Down Expand Up @@ -122,10 +123,10 @@ Flags: `--cloud`, `--kind` (1), `--library` (1), `--limit` (1), `--sound`.
Access: HOST (starts the app), then PERSON to answer. Arguments besides flags: any number.

```
raea show FILE... [--title T] [--ask LINE] [--project P] [--replaces ITEM] [--as NAME] [--role ROLE] [--inbox NAME] [--open] | raea show --question Q --choice A --choice B [STILL...] | raea show [--title T] --question Q [--preview FILE] --choice A [--preview FILE] --choice B ... [--question Q2] ... | raea show --on ITEM [--working ID] [--ask TEXT] [--status S] [--states S1,S2] [--sign N --clip FILE --render HASH] [--done ID] [--note LINE] [--sub NAME] (shown in the raea app as an item the person can use and answer, posted quietly with a notice, the window left where they are unless --open: stills (several, a storyboard), a video, a sound, a NAME.script.ts or .md, a .tsx (an interactive artifact; a project's composition opens in its editor), or questions, all of them one item, each question and choice with a --preview to play or read while answering (a still, a video, a sound, a script or .md; after a --choice that choice's, else the question's); what they send comes to ~/.raea/inbox/INBOX.jsonl; their edit comments are tasks: --working ID as you start one (each --ask with it one ask you read it as, for the person to correct; --status and --states where the note and each ask stand: to restate, to check, failing, to sign, passing, signed; --sign N --clip FILE --render HASH a clip under ask N for them to sign; a note closes when they retire it, never with --done), --done ID when it's settled, or with the version that settles it, FILE --replaces ITEM --done ID; never open media in Preview while the app is installed)
raea show FILE... [--title T] [--ask LINE] [--project P] [--replaces ITEM] [--as NAME] [--role ROLE] [--inbox NAME] [--open] [--label LABEL] [--detail PARAGRAPH] [--labels FILE.json] | raea show --question Q --choice A --choice B [STILL...] | raea show [--title T] --question Q [--preview FILE] --choice A [--preview FILE] --choice B ... [--question Q2] ... | raea show --on ITEM [--working ID] [--ask TEXT] [--status S] [--states S1,S2] [--sign N --clip FILE --render HASH] [--done ID] [--note LINE] [--sub NAME] (shown in the raea app as an item the person can use and answer, posted quietly with a notice, the window left where they are unless --open: stills (several, a storyboard), a video, a sound, a NAME.script.ts or .md, a .tsx (an interactive artifact; a project's composition opens in its editor), or questions, all of them one item; --label "PLACE TAG" a label beside the picture, never on it, that points at PLACE (x0,y0,x1,y1 or x,y in its 0-1, then #N the Nth file, @T or @T-TO a film's seconds, or part=KEY a scene's part; the tag the rest), --detail the paragraph of the --label before it, --labels a JSON list of them as feed_post takes them, and a sheet raea media sheet made comes labelled; each question and choice with a --preview to play or read while answering (a still, a video, a sound, a script or .md; after a --choice that choice's, else the question's); what they send comes to ~/.raea/inbox/INBOX.jsonl; their edit comments are tasks: --working ID as you start one (each --ask with it one ask you read it as, for the person to correct; --status and --states where the note and each ask stand: to restate, to check, failing, to sign, passing, signed; --sign N --clip FILE --render HASH a clip under ask N for them to sign; a note closes when they retire it, never with --done), --done ID when it's settled, or with the version that settles it, FILE --replaces ITEM --done ID; never open media in Preview while the app is installed)
```

Flags: `--as` (1), `--ask` (1), `--choice` (1), `--clip` (1), `--done` (1), `--inbox` (1), `--note` (1), `--on` (1), `--open`, `--preview` (1), `--project` (1), `--question` (1), `--render` (1), `--replaces` (1), `--role` (1), `--sign` (1), `--states` (1), `--status` (1), `--sub` (1), `--title` (1), `--working` (1).
Flags: `--as` (1), `--ask` (1), `--choice` (1), `--clip` (1), `--detail` (1), `--done` (1), `--inbox` (1), `--label` (1), `--labels` (1), `--note` (1), `--on` (1), `--open`, `--preview` (1), `--project` (1), `--question` (1), `--render` (1), `--replaces` (1), `--role` (1), `--sign` (1), `--states` (1), `--status` (1), `--sub` (1), `--title` (1), `--working` (1).

## raea clothes

Expand Down
1 change: 1 addition & 0 deletions skills/raea/reference/feed.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ Post an item to the project's feed: a render to watch (.mp4), a still to look at
| `tags` | optional | tags; key:value tags (platform:tiktok, aspect:9x16, cut:15s, market:uk) become the Table's columns, so use the same keys across a project's exports |
| `uses` | optional | the library files it was made from (footage, stills, music) |
| `controls` | optional | play: the game's controls |
| `labels` | optional | what each part of it is, shown as tags beside the picture that point at their place on hover: when one still holds several things (a contact sheet, a side by side, before and after, a grid of props), label each instead of naming them by position in the title. A few words each, a detail paragraph only when a tag isn't enough. Places are fractions of the picture, 0-1 from its top left |

## feed_propose

Expand Down
Loading