Skip to content

Commit 341fdd3

Browse files
docs(skills): reverse-any-video runs sign-in and payment itself and opens the result (#7101)
* docs(skills): reverse-any-video runs sign-in and payment itself and opens the result From Wenbo's end-to-end reverse test (F1, F2, F8, F9, F12, F13): - the person types nothing: the agent runs auth login, billing subscribe and billing top-up itself and gives each page as a clickable link - never sign in with an API key to get past Pro - reverse start's plan is final; auth status is read only for a null plan, and its hyperframes field, never user.subscription - an old CLI without reverse start: run this run as npx -y hyperframes@latest - hand over: side by side from diff --sbs, Studio preview, Framey line - animated shots: cut the guide inside a dissolve, retime each generated shot * docs(skills): reverse sign-in names --device, reads auth status --json, trims dissolve frames Rames's three wording notes on #7101, and the old-CLI subscribe line now applies only to a plugin's pinned CLI, beside main's null upgrade_url rule. * docs(skills): a plugin whose CLI can't reverse stops before payment Jerrai on #7101: the plugin fallback sent the person to subscribe when the pinned CLI has no reverse start, so the run could not go on after paying. It now stops and says the plugin needs updating.
1 parent 3aaed65 commit 341fdd3

4 files changed

Lines changed: 39 additions & 33 deletions

File tree

‎skills-manifest.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
"files": 76
2727
},
2828
"reverse-any-video": {
29-
"hash": "e809ebdad20e0f9a",
29+
"hash": "9d9db28adf68ba87",
3030
"files": 5
3131
},
3232
"slideshow": {

‎skills/reverse-any-video/SKILL.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,6 @@ What decides whether drawn things match, in `references/match.md`: text sized fr
3232

3333
1. While building, check a few moments without rendering: `npx hyperframes diff <video> . --at t,t,…`.
3434
2. When every shot has content: `npx hyperframes check` and fix its errors. Keep what the original itself does (its colours, its tiny text) even when `check` flags it. Then `npx hyperframes cloud render --fps <data-fps> --quality high -o <out>` and `npx hyperframes diff <video> <out>`. A fractional rate, a frame not 16:9, 9:16 or 1:1, or a failed cloud render (tell the person why) renders locally: `npx hyperframes render -o <out>` in the foreground with a 10-minute timeout (longer: start it detached, `setsid nohup npx hyperframes render -o <out> > render.log 2>&1 &`, and wait on the log in the foreground). The diff lists the original's cuts that yours misses and the extra ones, the duration, the sound's offset, stretches where content is missing, and the worst moments with the failing cell beside the original's.
35-
3. Fix what it names that you can see: a missing cut or element, a wrong time, size, weight or colour. Render and diff once more, then stop. Small score differences are not worth another round.
35+
3. Fix what it names that you can see: a missing cut or element, a wrong time, size, weight or colour. Render and diff once more, then stop.
3636

37-
Work alone: one agent holding the whole film beats subagents that each re-watch it. Write a short `REVERSE.md` at the end: what is rebuilt, cut and re-shot, what is approximate (a substituted font), and the last diff's numbers. It holds no prices or credit numbers. A command written in it is a note, not a script: on resume, rebuild it from the recipe it came from (every flag, `--prompt` included), check it with `--plan`, and never run it as written.
37+
Work alone: one agent holding the whole film beats subagents that each re-watch it. Write a short `REVERSE.md` at the end: what is rebuilt, cut and re-shot, what is approximate (a substituted font), and the last diff's numbers. It holds no prices or credit numbers. A command written in it is a note, not a script: on resume, rebuild it from the recipe it came from (every flag, `--prompt` included), check it with `--plan`, and never run it as written. Hand over per `references/start.md`.

‎skills/reverse-any-video/references/animated.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,9 @@ Work as `people.md` does, one generated shot per original shot, with these chang
2525
--aspect <the source's> --seconds <n> --prompt "<the painting style, what moves, the camera>" --out <shot>.mp4
2626
```
2727
28-
`--first-frame` does not combine with `--motion`, so the plate goes in `--reference`. Name the style in the prompt, and blank drawn text in the guide with `--mask`.
28+
`--first-frame` does not combine with `--motion`, so the plate goes in `--reference`. Name the style in the prompt, and blank drawn text in the guide with `--mask`. Trim the guide to the shot's own frames: leave out the blended frames of a dissolve at either end, or it comes back as the neighbouring shot.
2929

3030
4. **Frame it** by comparing a stable shape at the shot's start and end with `npx hyperframes diff <video> . --at t,t,…`, then set scale and position by hand. `measure face` is for real faces.
31+
5. **Retime it.** HeyGen performs the camera's moves late, so a generated shot rarely lines up as it comes back. Match its moves to the original's frames and set the clip's `data-media-start` and `data-playback-rate` to fit, shot by shot.
3132

3233
`REVERSE.md` lists which shots are generated and which layers are code.

‎skills/reverse-any-video/references/start.md‎

Lines changed: 34 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,56 @@
11
# Opening a Reverse
22

33
What the person reads at the start, and when credits run out mid-run. Write it for them, not for an agent:
4-
their language, warm and short, no file names, step numbers or tool names. Show any command they type as a code
5-
block they can copy.
4+
their language, warm and short, no file names, step numbers or tool names. They type nothing: you run every command,
5+
and any page they need (sign-in, upgrade, top-up) goes in your message as a plain link they can click, in case the
6+
browser did not open.
67

78
For you, not them: run `npx hyperframes events --skill=reverse-any-video` as you start, and
89
`npx hyperframes events --skill=reverse-any-video --event=skill_completed --outcome=success` when you hand over the
910
video (`--outcome=error` when you stop without one).
1011

1112
Also for you: `npx hyperframes reverse start <video> --dir <project>` prints the video's probe and a `reverse` field.
12-
`signed_in` and `plan` (`free` or `pro`) pick the section below; a `null` plan is unknown, so ask
13-
`npx hyperframes auth status`. `<project>` is the folder you build in: afterwards run `npx hyperframes init <project> --video <video> --keep-original --skip-transcribe`,
13+
`signed_in` and `plan` (`free` or `pro`) pick the section below, and that plan is final. Only a `null` plan is unknown:
14+
then ask `npx hyperframes auth status --json` and read its `hyperframes` field, never `user.subscription`, which is the HeyGen
15+
app's plan and does not unlock Reverse. `<project>` is the folder you build in: afterwards run `npx hyperframes init <project> --video <video> --keep-original --skip-transcribe`,
1416
which copies the video in untouched under its own file name and keeps the session it saved for `cloud render`. Keep the video out of `<project>` until then: `init`
15-
refuses a folder that already holds other files. A CLI that does not know `reverse start` yet: use `auth status` for the sign-in and
16-
plan and `npx hyperframes measure probe <video>` for the probe.
17+
refuses a folder that already holds other files. Outside a plugin, a CLI that does not know `reverse start` is an old
18+
install (often a global one) shadowing the current release: run every command of this run as
19+
`npx -y hyperframes@latest <command>`, and tell the person in one line that their installed HyperFrames is out of date.
20+
Inside a plugin, its pinned CLI is the one that runs: if it does not know `reverse start`, stop before anything is paid
21+
for, and tell the person in one line that the HyperFrames plugin needs updating to reverse a video.
1722

1823
## Not signed in yet
1924

2025
Say why HeyGen matters before asking: signing in is what gets the best remake. HeyGen re-shoots the people in the
2126
video, so they move and speak as they do in the original. For example:
2227

2328
> To rebuild this video at its best, I'll work with HeyGen: it re-shoots the people in it, so they move and speak just
24-
> like the original. Sign in once by typing this in the prompt:
25-
>
26-
> ```
27-
> ! npx hyperframes auth login
28-
> ```
29-
>
30-
> Your browser opens the HeyGen sign-in. Once you're in, reply "done".
29+
> like the original. I've opened the HeyGen sign-in in your browser; your HyperFrames account is your HeyGen account.
30+
> I'll carry on as soon as you're in.
3131
>
3232
> Then it takes about 20–50 minutes: I study the video frame by frame, rebuild every layer as a project you can edit,
3333
> and check it against the original until it matches.
3434
35+
Run `npx hyperframes auth login` yourself in the same message and wait for it: it opens the browser and returns once
36+
they are signed in. When the browser does not open, it prints the sign-in link: give it. When it refuses as a remote or
37+
headless terminal, run `npx hyperframes auth login --device` and give the link it prints, and the code when it shows
38+
one. Never sign in with an API key to get past Pro: that signs in a HeyGen app account, which has no HyperFrames plan.
39+
3540
## Signed in on Free
3641

3742
Reverse is part of Pro. Say why in one line, then run the `reverse.subscribe_command` from `reverse start` exactly as
3843
printed (`npx hyperframes billing subscribe --feature reverse --session <id>`): it opens the plans page in the person's
3944
browser, credits the purchase to this run, and waits until they are on Pro, so the run goes on by itself. Start nothing
40-
before it finishes. For example:
45+
before it finishes. Give the `reverse.upgrade_url`, when it isn't `null`, as a link in the same message. For example:
4146

4247
> Reverse is part of HyperFrames Pro: it re-shoots the people in your video with HeyGen. I've opened the upgrade page in
43-
> your browser and I'll carry on as soon as you're subscribed.
48+
> your browser (or open it here: <upgrade_url>) and I'll carry on as soon as you're subscribed.
4449
4550
When `reverse start` refuses the run (it exits with an error whose `fix` is that command), run the `fix` the same way,
4651
then run `reverse start` again. When `subscribe_command` is `null` (or the refusal names no command), a plan can't be
47-
purchased right now: say so plainly, give no link, run nothing, and stop. Only on a CLI without `reverse start`, run
48-
`npx hyperframes billing subscribe` instead. If the command times out, tell the person and run it again once they say
49-
they are ready.
52+
purchased right now: say so plainly, give no link, run nothing, and stop. If the command times out, tell the person
53+
and run it again once they say they are ready.
5054

5155
## Signed in on Pro
5256

@@ -61,18 +65,19 @@ the end of a run. `reverse start` and `auth status` are for the sign-in: never r
6165

6266
A refused step prints what it needs and the command that fixes it (top up, or pick a plan). Shots are launched all
6367
at once, so several refuse together: wait until every launched step has answered, add up what each refused step
64-
needs, and ask once for that total (`--needed <total>`), never for one step at a time. If a refusal prints no
65-
amount, run plain `billing top-up` for that one. Then relaunch every refused
66-
step after they reply. Never trim the plan to fit.
68+
needs, and run `npx hyperframes billing top-up --needed <total>` once for that total, never one step at a time. If a
69+
refusal prints no amount, run plain `billing top-up` for that one. It opens the top-up page and waits until the balance
70+
covers the total; give the refusal's `url` (on an older CLI, the link in its `fix`) as a link in the same message.
71+
Then relaunch every refused step. Never trim the plan to fit.
6772

68-
> Three steps need 180, 180 and 273 credits and you have 30. Add credits by typing this in the prompt:
69-
>
70-
> ```
71-
> ! npx hyperframes billing top-up --needed 633
72-
> ```
73-
>
74-
> It opens the top-up page and finishes once your balance covers all of them. Reply "done" and I'll pick up right
75-
> where I stopped.
73+
> Three steps need 633 credits together and you have 30. I've opened the top-up page in your browser (or open it here:
74+
> <url>); I'll pick up right where I stopped once your balance covers them.
75+
76+
## Handing it over
77+
78+
They see the result, not file paths. Run the last diff with `--sbs` and open the side by side it writes (original |
79+
yours), start `npx hyperframes preview` on the project, and say in one line that they can keep editing there; pass on
80+
its Framey line as `/hyperframes` does. Then send `skill_completed`.
7681

7782
## Time
7883

0 commit comments

Comments
 (0)