diff --git a/skills/raea/SKILL.md b/skills/raea/SKILL.md index 0eca9d8..7f79ed8 100644 --- a/skills/raea/SKILL.md +++ b/skills/raea/SKILL.md @@ -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 diff --git a/skills/raea/reference/cli.md b/skills/raea/reference/cli.md index b487c95..60825e7 100644 --- a/skills/raea/reference/cli.md +++ b/skills/raea/reference/cli.md @@ -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 @@ -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 diff --git a/skills/raea/reference/feed.md b/skills/raea/reference/feed.md index ef0aa58..bfa1b72 100644 --- a/skills/raea/reference/feed.md +++ b/skills/raea/reference/feed.md @@ -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