Skill: a video upload is held to the project's plan limit

States 500 MB on Standard and 1 GB on every other plan, where project
capabilities reports media_video_bytes. The bundled CLI (804fbae) already reads
the project's limit; this rebuild also carries the playlists reference that was
waiting in skills/.

Budget: repository 109 files, 3,488,885 -> 3,490,708 bytes; plugins/screenrig
50 files, 2,448,089 -> 2,449,710 bytes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Author: gersham

plugins/screenrig/skills/screenrig/SKILL.md

@@ -172,6 +172,7 @@ never the providers.
 names what is missing, so ask the user to install ffmpeg rather than installing
 software yourself. Give uploads distinctive filenames and letter-or-digit tags.
 An image or video up to 16383 pixels per edge and 8192 by 8192 pixels in area uploads, so an ultra-wide LED master such as 9216 by 2160 goes up with `--no-transcode`; the default transcode fits each edge within 3840 pixels.
+A video upload can be at most the project's plan limit, 500 MB on Standard and 1 GB on every other plan (`project capabilities` states `media_video_bytes`); a larger video is refused before it is read.
 A Raspberry Pi 5 (`screen show` names the model, or firmware ending `rpi-2712`)
 has no H.264 decoder: upload every video for it with `--codec hevc`, up to 4K at
 60 fps, and never offer or retry H.264 when one fails.
@@ -189,6 +190,13 @@ moves its contents up one level. A `folder` selector plays a folder's own files,
 so moving files or deleting the folder changes what those playlists show; under
 Propose access a move waits for a person's review.
 
+For a share of voice (sponsors, ad rotation) tag each sponsor's files and give
+the selector `order: "weighted"`, `one_at_a_time: true` and `weights` keyed by
+`tag:SPONSOR`; 50/30/20 plays exactly 5/3/2 of every 10. For a portrait or
+landscape slot add `fit: "aspect"`. Before publishing run `media
+selector-preview FILE --primitive image --rect WxH` and read each `share_percent`
+(`references/playlists.md`).
+
 Match the design to the screen's dimensions. Generate a finished still whole, not
 a background with composed text. Use real supplied facts, label invented demo
 content, and inspect every render at full size before publishing.

plugins/screenrig/skills/screenrig/references/playlists.md

@@ -171,7 +171,21 @@ video of its folders only (a stinger transition's logo included);
   resolve at each loop; on duration, application and `audio_end` pages they
   need `one_at_a_time: true`. `media_end` is valid only on a page with exactly
   one image or video; an image there needs `dwell_ms`, a video must not loop.
-  Use `media selector-preview` to inspect a selector.
+  Use `media selector-preview FILE --primitive image|video [--rect WxH]` to
+  inspect a selector.
+- Weighted order (share of voice, sponsor rotation): `order: "weighted"` with
+  `weights`, both or neither, plus `one_at_a_time: true` or `batch_size: 1`.
+  `weights` maps `med_` IDs or `tag:NAME` to 1-1000 (64 keys at most); 50/30/20
+  plays exactly 5/3/2 of every 10. An item takes its `med_` key, else its first
+  `tag:` key alphabetically (that weight split among the items carrying it), else
+  weight 1. Key each sponsor by `tag:` so its share holds however many creatives
+  it has. A Player without `selector.weighted` plays random
+  (`selector_order_downgraded`); static export drops weights.
+- `fit: "aspect"` on a dynamic selector keeps files within 5% of the slot's
+  width over height, so a portrait slot never plays a landscape file. Preview
+  needs `--rect WxH` with it and lists the rest as `excluded`
+  (`aspect_mismatch`); weighted previews give each item's `weight`,
+  `share_percent` and the `cycle`, and signed-in `playlist preview` prints them.
 - `iframe` and `application` use `content_fit: "fill"`; `application` pins a
   `release_id`. A `stream` needs `fallback_media_id` and a `duration` page. Its
   `sources` take an `https` HLS URL or a camera's `rtsp://`/`rtsps://` URL as

skills/screenrig/SKILL.md

@@ -172,6 +172,7 @@ never the providers.
 names what is missing, so ask the user to install ffmpeg rather than installing
 software yourself. Give uploads distinctive filenames and letter-or-digit tags.
 An image or video up to 16383 pixels per edge and 8192 by 8192 pixels in area uploads, so an ultra-wide LED master such as 9216 by 2160 goes up with `--no-transcode`; the default transcode fits each edge within 3840 pixels.
+A video upload can be at most the project's plan limit, 500 MB on Standard and 1 GB on every other plan (`project capabilities` states `media_video_bytes`); a larger video is refused before it is read.
 A Raspberry Pi 5 (`screen show` names the model, or firmware ending `rpi-2712`)
 has no H.264 decoder: upload every video for it with `--codec hevc`, up to 4K at
 60 fps, and never offer or retry H.264 when one fails.