agentleFS
Sign inStart free
bloxy-studiosbloxy-studios/shorts-studio/skills/reframe/SKILL.md

reframe

Skill0 starsChanged 42 days agoMITView on GitHub

Vertical reframing that follows who is speaking: face tracks, mouth-activity speaker turns with hysteresis and minimum holds, two-shots or stacks for rapid exchanges, off-camera voices, reaction shots, screen-aware layouts, jump-cut punch-ins where the preset allows — and static held crops for presets (Luxury Tech) that forbid footage motion.

8 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Look first: read qa/cuts.jpg/qa/contact.jpg of the latest render and the analysis sheets for the range.

    line 33

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Reframe

Rules: ${CLAUDE_PLUGIN_ROOT}/references/rules.md · CLI: ${CLAUDE_PLUGIN_ROOT}/references/cli.md. ss = "${CLAUDE_PLUGIN_ROOT}/bin/shorts-studio". Input: $ARGUMENTS

0. Engine check

The commands below run the Shorts Studio engine. Installed as the Claude Code plugin it is already present and shorts-studio is on the Bash PATH. If shorts-studio doctor is not found (for example, this skill was added with npx skills add), ask the user before installing anything, then:

  • Claude Code: /plugin marketplace add bloxy-studios/shorts-studio → /plugin install shorts-studio@shorts-studio.
  • Other agents: git clone --depth 1 https://github.com/bloxy-studios/shorts-studio ~/.shorts-studio/engine and read every ${CLAUDE_PLUGIN_ROOT} path below as ~/.shorts-studio/engine.

Then run shorts-studio doctor --setup once (project-local runtime; never sudo or global installs).

Steps

  1. Look first: read qa/cuts.jpg/qa/contact.jpg of the latest render and the analysis sheets for the range. Speaker detection is mouth activity normalized per face (evidence, not certainty); a laughing listener can be mistaken for the speaker — check frames.
  2. Record what you see: ss analyze note <project> --kind reaction --at 0:12.4 --detail "host laughs, guest speaking".
  3. Fix with targeted ops (other runs untouched): keep-both-visible (two-shot/stack over a range), switch-speaker (at a time, optional trackId), reduce-motion (holds instead of follows). Then ss render.
  4. Luxury Tech: footage never moves — layouts change instead (luxury-tech skill).

Limits

Face tracking samples 5 fps (denser around turns); profile faces and heavy occlusion reduce confidence; off-camera voices keep the previous framing or a wide/stack layout and are logged.

Completion check

On rendered frames the active speaker is framed in every run you changed, no unrequested reframes appear elsewhere, and captions.face-collision passes.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free