mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 07:50:13 +00:00
feat(skills): reverse-any-video and style-sampling install with the core set (#7445)
* feat(skills): reverse-any-video and style-sampling install with the core set A skill only triggers when it is installed. On demand these two rarely were, so a request to copy a video or make an episode in a proven style seldom reached them, and the entry skill named only one of them, in its closing line. - isCoreSkill, FALLBACK_CORE_SKILLS and the marketplace `core-skills` entry include both, so `init` and `skills update` install them. The `hyperframes` plugin already bundled every skill. - `/hyperframes` routes to both from the top of its table: a video to copy or remake, and an episode in a proven style. Its budget takes +64 B for those two rows. - `/reverse-any-video` triggers on "remake" and on 「复刻这个视频」 「照着做一个」, inside the 320 B description cap. - Every catalog surface lists both in the core group: CLAUDE.md, AGENTS.md, README, the skills guide, skill-lifecycle and the two init templates (still byte-identical). * refactor(cli): keep comment share at the base in skillsManifest
This commit is contained in:
@@ -23,7 +23,9 @@
|
||||
"./skills/hyperframes",
|
||||
"./skills/hyperframes-cli",
|
||||
"./skills/hyperframes-registry",
|
||||
"./skills/media-use"
|
||||
"./skills/media-use",
|
||||
"./skills/reverse-any-video",
|
||||
"./skills/style-sampling"
|
||||
]
|
||||
}
|
||||
],
|
||||
|
||||
@@ -4,7 +4,7 @@ Open-source video rendering framework: write HTML, render video.
|
||||
|
||||
## Skills
|
||||
|
||||
This repo ships AI agent skills via [vercel-labs/skills](https://github.com/vercel-labs/skills). Install them before writing compositions — they encode framework-specific patterns that generic docs don't cover. **Default to the core set** (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`); install everything only when the user explicitly asks for the full set.
|
||||
This repo ships AI agent skills via [vercel-labs/skills](https://github.com/vercel-labs/skills). Install them before writing compositions — they encode framework-specific patterns that generic docs don't cover. **Default to the core set** (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`, `/reverse-any-video`, `/style-sampling`); install everything only when the user explicitly asks for the full set.
|
||||
|
||||
```bash
|
||||
npx hyperframes skills update # default: installs/refreshes the core set plus anything already installed
|
||||
@@ -18,11 +18,11 @@ Make any video by asking for it; the `/hyperframes` skill carries the contract a
|
||||
- `/hyperframes-cli` — the HyperFrames CLI by job: scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history; plus reading its JSON and recovering from build or render failures.
|
||||
- `/hyperframes-registry` — about 450 ready-made blocks and components installed as editable source. Use before hand-building any named visual; also for `hyperframes add` and `catalog`.
|
||||
- `/media-use` — get or make any media for a video (music, sound effects, images, voiceover, avatar and generated video, transcripts, cutouts, colour grades) with HeyGen or free local tools, and mix placed audio.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project (motion graphics, talking heads, live action or AI-generated footage) and check the render against the original frame by frame. A HyperFrames Pro feature.
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime). A HyperFrames Pro feature.
|
||||
- `/figma` — bring Figma into a video: rendered assets, brand tokens, components, storyboard frames as reconstructed motion.
|
||||
- `/slideshow` — a presentation, pitch deck or interactive deck. Output is a navigable deck, not a rendered MP4.
|
||||
- `/remotion-to-hyperframes` — bring existing video code or footage into HyperFrames (Remotion first; also Motion Canvas, Lottie, Three.js, canvas, or renders from other tools) and verify it frame by frame against the original.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project (motion graphics, talking heads, live action or AI-generated footage) and check the render against the original frame by frame. A HyperFrames Pro feature.
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime). A HyperFrames Pro feature.
|
||||
|
||||
## Issue and PR triage
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ Open-source video rendering framework: write HTML, render video.
|
||||
|
||||
## Skills
|
||||
|
||||
This repo ships 9 AI agent skills via [vercel-labs/skills](https://github.com/vercel-labs/skills). Install them before writing compositions — they encode framework-specific patterns that generic docs don't cover. **Default to the core set** (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`); `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video`, `/style-sampling` and `/figma` install on demand. Install all 9 only when the user explicitly asks for the full set.
|
||||
This repo ships 9 AI agent skills via [vercel-labs/skills](https://github.com/vercel-labs/skills). Install them before writing compositions — they encode framework-specific patterns that generic docs don't cover. **Default to the core set** (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`, `/reverse-any-video`, `/style-sampling`); `/slideshow`, `/remotion-to-hyperframes` and `/figma` install on demand. Install all 9 only when the user explicitly asks for the full set.
|
||||
|
||||
```bash
|
||||
npx hyperframes skills update # default: installs/refreshes the core set plus anything already installed
|
||||
@@ -24,11 +24,11 @@ Make any video by asking for it; the `/hyperframes` skill carries the render con
|
||||
- `/hyperframes-cli` — the HyperFrames CLI by job: scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history; plus reading its JSON and recovering from build or render failures.
|
||||
- `/hyperframes-registry` — about 450 ready-made blocks and components installed as editable source: transitions, overlays, titles, kinetic type, captions, charts, maps, 3D, camera moves. Use before hand-building any named visual; also for `hyperframes add` and `catalog`.
|
||||
- `/media-use` — get or make any media for a video (music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks) with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project (motion graphics, talking heads, live action or AI-generated footage) and check the render against the original frame by frame. A HyperFrames Pro feature.
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime). A HyperFrames Pro feature.
|
||||
- `/figma` — bring Figma into a video: rendered assets, brand tokens, components, storyboard frames as reconstructed motion, shaders and connector-assisted motion. Use when the person pastes a figma.com link or asks to use a Figma design, frame, logo or brand.
|
||||
- `/slideshow` — a presentation, pitch deck or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation and presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4.
|
||||
- `/remotion-to-hyperframes` — bring existing video code or footage into HyperFrames (Remotion first; also Motion Canvas, Lottie, Three.js, canvas, or renders from other tools) and verify it frame by frame against the original.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project (motion graphics, talking heads, live action or AI-generated footage) and check the render against the original frame by frame. A HyperFrames Pro feature.
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime). A HyperFrames Pro feature.
|
||||
|
||||
## Skill catalog maintenance
|
||||
|
||||
@@ -37,7 +37,7 @@ When adding a new skill, or substantially renaming / repurposing an existing one
|
||||
1. The skill list above (CLAUDE.md) AND the skill list in the root `AGENTS.md` AND the `## Skills` section in `README.md` AND `docs/guides/skills.mdx` (rendered at [hyperframes.heygen.com/guides/skills](https://hyperframes.heygen.com/guides/skills)) AND the two setup pages that compress the same descriptions — `docs/prompting/overview.mdx` ("One-time setup") and `docs/quickstart.mdx`. Out-of-date entries silently kill discovery. This list is also the sync set for a **changed contract**, not just an added or renamed skill: a reworded `description:` has to be pushed to every surface or the compressed copies start asserting the opposite of the skill.
|
||||
2. The scaffolded project template `packages/cli/src/templates/_shared/CLAUDE.md` + `AGENTS.md` — written into every `hyperframes init` project, so a stale entry there ships to users. The two template files must stay byte-identical.
|
||||
3. The routing surface for "make a video" requests is the References table and closing line of `skills/hyperframes/SKILL.md`. A new reference or skill that a request should reach gets a row or a mention there.
|
||||
4. Keep the same grouping on every surface: the core set (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`) first, then the on-demand skills (`/figma`, `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video`).
|
||||
4. Keep the same grouping on every surface: the core set (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`, `/reverse-any-video`, `/style-sampling`) first, then the on-demand skills (`/figma`, `/slideshow`, `/remotion-to-hyperframes`). Core membership is `isCoreSkill` in `packages/cli/src/utils/skillsManifest.ts` and the `core-skills` entry of `.claude-plugin/marketplace.json`.
|
||||
5. Skill count appears in the README and CLAUDE.md intro lines ("8 AI agent skills…") — update on add/remove. The `docs/guides/skills.mdx` page and the CLI templates deliberately omit a count to avoid drift; keep them count-free.
|
||||
|
||||
The skill's own `SKILL.md` frontmatter `description:` is the source of truth for the one-line "use when" blurb; copy from there into the catalog rather than paraphrasing.
|
||||
|
||||
@@ -66,7 +66,7 @@ For standalone skills (including OpenCode), use:
|
||||
npx skills add heygen-com/hyperframes
|
||||
```
|
||||
|
||||
> The picker opens with nothing pre-selected — the **Core Skills** group is all you need; `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video`, `/style-sampling` and `/figma` install on demand. Without the picker (a script or a CI job), `npx hyperframes skills update` installs exactly the core set, whereas `skills add --all` installs all 9 published skills. The six repo-internal skills under `.claude/skills` / `.agents/skills` are excluded by default. For the full published set use `npx hyperframes skills`.
|
||||
> The picker opens with nothing pre-selected — the **Core Skills** group is all you need; `/slideshow`, `/remotion-to-hyperframes` and `/figma` install on demand. Without the picker (a script or a CI job), `npx hyperframes skills update` installs exactly the core set, whereas `skills add --all` installs all 9 published skills. The six repo-internal skills under `.claude/skills` / `.agents/skills` are excluded by default. For the full published set use `npx hyperframes skills`.
|
||||
>
|
||||
> `skills add` resolves the skills.sh registry blob, which can lag `main` by hours. `npx hyperframes skills update` installs the skills from the release tag that matches your CLI version, so they match the CLI that runs them.
|
||||
|
||||
@@ -85,9 +85,9 @@ The skills teach agents the HyperFrames production loop: plan the video, write v
|
||||
|
||||
HyperFrames ships 9 skills. Make any video by asking for it; the `/hyperframes` skill carries the contract and the references (film, captions, overlays, motion, look). Read it first.
|
||||
|
||||
For standalone installation, default to the **core set** (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`). `npx hyperframes skills update` installs exactly that from anywhere; the interactive picker (`npx skills add heygen-com/hyperframes`) lists it as the "Core Skills" group, nothing pre-selected. The picker is interactive-only — a non-interactive or agent run without `--skill` installs all 9. Use `npx skills add heygen-com/hyperframes --all` to install the complete published set deliberately (skips the picker), or `npx skills add heygen-com/hyperframes --skill <name>` for just one (bare name, no leading `/`).
|
||||
For standalone installation, default to the **core set** (`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`, `/reverse-any-video`, `/style-sampling`). `npx hyperframes skills update` installs exactly that from anywhere; the interactive picker (`npx skills add heygen-com/hyperframes`) lists it as the "Core Skills" group, nothing pre-selected. The picker is interactive-only — a non-interactive or agent run without `--skill` installs all 9. Use `npx skills add heygen-com/hyperframes --all` to install the complete published set deliberately (skips the picker), or `npx skills add heygen-com/hyperframes --skill <name>` for just one (bare name, no leading `/`).
|
||||
|
||||
Standalone installs stay lean after that: `npx hyperframes init` installs the **core set** only when it is missing and never touches a skill you already have (`npx hyperframes skills update` refreshes them, and never removes one); `/figma`, `/slideshow`, `/remotion-to-hyperframes` and `/reverse-any-video` install **on demand** with `npx hyperframes skills update <name>`. Nothing re-pulls the full set behind your back.
|
||||
Standalone installs stay lean after that: `npx hyperframes init` installs the **core set** only when it is missing and never touches a skill you already have (`npx hyperframes skills update` refreshes them, and never removes one); `/figma`, `/slideshow` and `/remotion-to-hyperframes` install **on demand** with `npx hyperframes skills update <name>`. Nothing re-pulls the full set behind your back.
|
||||
|
||||
### Plugin packages
|
||||
|
||||
@@ -113,6 +113,8 @@ This writes `dist/hyperframes-plugin.zip` with a `hyperframes/` root folder and
|
||||
| `/hyperframes-cli` | The HyperFrames CLI by job — scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history — plus reading its JSON and recovering from build or render failures. |
|
||||
| `/hyperframes-registry` | About 450 ready-made blocks and components installed as editable source — transitions, overlays, titles, kinetic type, captions, charts, maps, 3D, camera moves. Use before hand-building any named visual; also for `hyperframes add` and `catalog`. |
|
||||
| `/media-use` | Get or make any media for a video — music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks — with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull. |
|
||||
| `/reverse-any-video` | Rebuilding any video file as an editable HyperFrames project (motion graphics, talking heads, live action, AI-generated footage), checked frame by frame against the original. HyperFrames Pro. |
|
||||
| `/style-sampling` | Making a new episode on your topic in one of five proven styles: Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime. HyperFrames Pro. |
|
||||
|
||||
### On demand
|
||||
|
||||
@@ -121,8 +123,6 @@ This writes `dist/hyperframes-plugin.zip` with a `hyperframes/` root folder and
|
||||
| `/figma` | Bring Figma into a video — rendered assets, brand tokens, components, storyboard frames as reconstructed motion, shaders and connector-assisted motion. Use when you paste a figma.com link. |
|
||||
| `/slideshow` | A presentation, pitch deck or interactive deck — discrete slides, fragment reveals, branching, hotspot navigation, presenter mode with speaker notes. Output is a navigable deck, not a rendered MP4. |
|
||||
| `/remotion-to-hyperframes` | Bringing existing video code or footage into HyperFrames (Remotion first; also Motion Canvas, Lottie, Three.js, canvas, other tools' renders), verified frame by frame. |
|
||||
| `/reverse-any-video` | Rebuilding any video file as an editable HyperFrames project (motion graphics, talking heads, live action, AI-generated footage), checked frame by frame against the original. HyperFrames Pro. |
|
||||
| `/style-sampling` | Making a new episode on your topic in one of five proven styles: Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime. HyperFrames Pro. |
|
||||
|
||||
For visual design handoff workflows, see the [Claude Design guide](https://hyperframes.heygen.com/guides/design-tools?utm_source=github&utm_medium=readme#start-from-claude-design-or-open-design) and [Open Design guide](https://hyperframes.heygen.com/guides/design-tools?utm_source=github&utm_medium=readme#start-from-claude-design-or-open-design).
|
||||
|
||||
|
||||
@@ -131,11 +131,11 @@ Make any video by asking for it; the `/hyperframes` skill carries the contract a
|
||||
| `/hyperframes-cli` | The CLI by job: scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history. |
|
||||
| `/hyperframes-registry` | About 450 ready-made blocks and components installed as editable source: transitions, overlays, titles, kinetic type, captions, charts, maps, 3D, camera moves. |
|
||||
| `/media-use` | Music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks, with HeyGen or free local tools; mixes placed audio. |
|
||||
| `/reverse-any-video` | Rebuilding any video file as an editable HyperFrames project (motion graphics, talking heads, live action, AI-generated footage), checked frame by frame against the original. HyperFrames Pro. |
|
||||
| `/style-sampling` | Making a new episode on your topic in one of five proven styles: Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime. HyperFrames Pro. |
|
||||
| `/figma` | A Figma file or frame: rendered assets, brand tokens, components, and storyboard frames as reconstructed motion. |
|
||||
| `/slideshow` | A presentation, pitch deck or interactive deck. Output is a navigable deck, not a rendered MP4. |
|
||||
| `/remotion-to-hyperframes` | Bringing existing video code or footage into HyperFrames (Remotion first; also Motion Canvas, Lottie, Three.js, canvas, other tools' renders), verified frame by frame. |
|
||||
| `/reverse-any-video` | Rebuilding any video file as an editable HyperFrames project (motion graphics, talking heads, live action, AI-generated footage), checked frame by frame against the original. HyperFrames Pro. |
|
||||
| `/style-sampling` | Making a new episode on your topic in one of five proven styles: Collage Explainer, Finance Explainer, Animated Science Explainer, 3D Brand Explainer, 3D True Crime. HyperFrames Pro. |
|
||||
|
||||
You can name a skill directly, but you do not need to memorize the names to start.
|
||||
|
||||
|
||||
@@ -84,7 +84,7 @@ beforeEach(() => {
|
||||
store = join(home, ".claude", "skills");
|
||||
cursor = join(home, ".cursor", "skills");
|
||||
mkdirSync(cwd, { recursive: true });
|
||||
for (const name of [...FALLBACK_CORE_SKILLS, "reverse-any-video", "slideshow"]) {
|
||||
for (const name of [...FALLBACK_CORE_SKILLS, "remotion-to-hyperframes", "slideshow"]) {
|
||||
write(join(source, name, "SKILL.md"), `# ${name}\nCurrent release\n`);
|
||||
}
|
||||
manifest = buildManifest(source, { source: "heygen-com/hyperframes" });
|
||||
@@ -112,12 +112,12 @@ describe("skills update install destination", () => {
|
||||
"reports a requested foreign skill while offline (strict: %s)",
|
||||
async (strict) => {
|
||||
seedCore(store);
|
||||
const path = join(store, "reverse-any-video", "SKILL.md");
|
||||
const path = join(store, "remotion-to-hyperframes", "SKILL.md");
|
||||
write(path, "# Another publisher\n");
|
||||
write(
|
||||
join(home, ".agents", ".skill-lock.json"),
|
||||
JSON.stringify({
|
||||
skills: { "reverse-any-video": { source: "another/publisher" } },
|
||||
skills: { "remotion-to-hyperframes": { source: "another/publisher" } },
|
||||
}),
|
||||
);
|
||||
vi.stubGlobal(
|
||||
@@ -128,17 +128,17 @@ describe("skills update install destination", () => {
|
||||
);
|
||||
const warning = vi.spyOn(log, "warn").mockImplementation(() => {});
|
||||
|
||||
const update = updateSkills({ cwd, requested: ["reverse-any-video"], strict });
|
||||
const update = updateSkills({ cwd, requested: ["remotion-to-hyperframes"], strict });
|
||||
|
||||
if (strict) {
|
||||
await expect(update).rejects.toThrow(
|
||||
"Skill(s) owned by another publisher: reverse-any-video",
|
||||
"Skill(s) owned by another publisher: remotion-to-hyperframes",
|
||||
);
|
||||
} else {
|
||||
const result = await update;
|
||||
expect(result.unknown).toEqual(["reverse-any-video"]);
|
||||
expect(result.unknown).toEqual(["remotion-to-hyperframes"]);
|
||||
expect(warning).toHaveBeenCalledWith(
|
||||
expect.stringContaining("owned by another publisher: reverse-any-video"),
|
||||
expect.stringContaining("owned by another publisher: remotion-to-hyperframes"),
|
||||
);
|
||||
}
|
||||
expect(installer.run).not.toHaveBeenCalled();
|
||||
@@ -149,7 +149,7 @@ describe("skills update install destination", () => {
|
||||
it("installs the core in one run with only Cursor skills present, then becomes a no-op", async () => {
|
||||
seedCore(cursor);
|
||||
rmSync(join(cursor, "media-use"), { recursive: true });
|
||||
const optional = join(cursor, "reverse-any-video", "SKILL.md");
|
||||
const optional = join(cursor, "remotion-to-hyperframes", "SKILL.md");
|
||||
write(optional, "# Existing Cursor-only workflow\n");
|
||||
|
||||
const first = await updateSkills({ cwd, refreshInstalled: true, strict: true });
|
||||
@@ -160,7 +160,7 @@ describe("skills update install destination", () => {
|
||||
readFileSync(join(source, name, "SKILL.md"), "utf8"),
|
||||
);
|
||||
}
|
||||
expect(existsSync(join(store, "reverse-any-video"))).toBe(false);
|
||||
expect(existsSync(join(store, "remotion-to-hyperframes"))).toBe(false);
|
||||
expect(readFileSync(optional, "utf8")).toBe("# Existing Cursor-only workflow\n");
|
||||
if (process.platform !== "win32")
|
||||
expect(lstatSync(join(cursor, "hyperframes")).isSymbolicLink()).toBe(true);
|
||||
@@ -172,13 +172,13 @@ describe("skills update install destination", () => {
|
||||
|
||||
it("still refreshes an optional skill already installed in the managed store", async () => {
|
||||
seedCore(store);
|
||||
write(join(store, "reverse-any-video", "SKILL.md"), "# Stale workflow\n");
|
||||
write(join(store, "remotion-to-hyperframes", "SKILL.md"), "# Stale workflow\n");
|
||||
|
||||
const result = await updateSkills({ cwd, refreshInstalled: true, strict: true });
|
||||
|
||||
expect(result.installed).toEqual(["reverse-any-video"]);
|
||||
expect(readFileSync(join(store, "reverse-any-video", "SKILL.md"), "utf8")).toBe(
|
||||
readFileSync(join(source, "reverse-any-video", "SKILL.md"), "utf8"),
|
||||
expect(result.installed).toEqual(["remotion-to-hyperframes"]);
|
||||
expect(readFileSync(join(store, "remotion-to-hyperframes", "SKILL.md"), "utf8")).toBe(
|
||||
readFileSync(join(source, "remotion-to-hyperframes", "SKILL.md"), "utf8"),
|
||||
);
|
||||
expect(existsSync(join(store, "slideshow"))).toBe(false);
|
||||
});
|
||||
@@ -247,16 +247,16 @@ describe("skills update install destination", () => {
|
||||
write(
|
||||
join(home, ".agents", ".skill-lock.json"),
|
||||
JSON.stringify({
|
||||
skills: { "reverse-any-video": { source: "another/publisher" } },
|
||||
skills: { "remotion-to-hyperframes": { source: "another/publisher" } },
|
||||
}),
|
||||
);
|
||||
seedCore(store);
|
||||
write(join(store, "reverse-any-video", "SKILL.md"), "# Another publisher\n");
|
||||
write(join(store, "remotion-to-hyperframes", "SKILL.md"), "# Another publisher\n");
|
||||
|
||||
const result = await updateSkills({ cwd: home, refreshInstalled: true, strict: true });
|
||||
|
||||
expect(result.installed).toEqual([]);
|
||||
expect(result.targets).not.toContain("reverse-any-video");
|
||||
expect(result.targets).not.toContain("remotion-to-hyperframes");
|
||||
expect(installer.run).not.toHaveBeenCalled();
|
||||
});
|
||||
});
|
||||
|
||||
@@ -14,11 +14,11 @@ MP4.
|
||||
- `/hyperframes-cli` — the CLI by job: scaffold, check, look at frames, edit the timeline, preview, render, publish, project history.
|
||||
- `/hyperframes-registry` — ready-made blocks and components installed as editable source. Search it before hand-building any named visual.
|
||||
- `/media-use` — get or make any media (music, sound effects, images, voiceover, avatar and generated video, transcripts, cutouts, colour grades) and mix placed audio.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project and check it against the original frame by frame (HyperFrames Pro).
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (HyperFrames Pro).
|
||||
- `/figma` — bring a Figma design, frame, logo or brand into a video.
|
||||
- `/slideshow` — a presentation or pitch deck. Output is a navigable deck, not a rendered MP4.
|
||||
- `/remotion-to-hyperframes` — bring existing video code or footage into HyperFrames (Remotion first; also Motion Canvas, Lottie, Three.js, canvas, or renders from other tools) and verify it frame by frame against the original.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project and check it against the original frame by frame (HyperFrames Pro).
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (HyperFrames Pro).
|
||||
|
||||
**Changing how real footage or images look or reveal?** Load `/media-use` and read its `references/media-treatments.md` before editing, even when the request only says dark, flat, boring, retro, private, or “make the reveal cooler.” It governs how footage is treated, never whether media may be used. Use canonical media treatments and seek-safe motion; do not improvise equivalent CSS/SVG filters or overlays.
|
||||
|
||||
|
||||
@@ -14,11 +14,11 @@ MP4.
|
||||
- `/hyperframes-cli` — the CLI by job: scaffold, check, look at frames, edit the timeline, preview, render, publish, project history.
|
||||
- `/hyperframes-registry` — ready-made blocks and components installed as editable source. Search it before hand-building any named visual.
|
||||
- `/media-use` — get or make any media (music, sound effects, images, voiceover, avatar and generated video, transcripts, cutouts, colour grades) and mix placed audio.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project and check it against the original frame by frame (HyperFrames Pro).
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (HyperFrames Pro).
|
||||
- `/figma` — bring a Figma design, frame, logo or brand into a video.
|
||||
- `/slideshow` — a presentation or pitch deck. Output is a navigable deck, not a rendered MP4.
|
||||
- `/remotion-to-hyperframes` — bring existing video code or footage into HyperFrames (Remotion first; also Motion Canvas, Lottie, Three.js, canvas, or renders from other tools) and verify it frame by frame against the original.
|
||||
- `/reverse-any-video` — rebuild any video file as an editable HyperFrames project and check it against the original frame by frame (HyperFrames Pro).
|
||||
- `/style-sampling` — make a new episode on your topic in one of five proven styles (HyperFrames Pro).
|
||||
|
||||
**Changing how real footage or images look or reveal?** Load `/media-use` and read its `references/media-treatments.md` before editing, even when the request only says dark, flat, boring, retro, private, or “make the reveal cooler.” It governs how footage is treated, never whether media may be used. Use canonical media treatments and seek-safe motion; do not improvise equivalent CSS/SVG filters or overlays.
|
||||
|
||||
|
||||
@@ -132,11 +132,13 @@ describe("buildManifest", () => {
|
||||
});
|
||||
|
||||
describe("isCoreSkill", () => {
|
||||
it("classifies the entry router, hyperframes-* domain skills, and media-use as core", () => {
|
||||
it("classifies the entry router, hyperframes-* domain skills, media-use and the video rebuilds as core", () => {
|
||||
expect(isCoreSkill("hyperframes")).toBe(true);
|
||||
expect(isCoreSkill("hyperframes-cli")).toBe(true);
|
||||
expect(isCoreSkill("hyperframes-registry")).toBe(true);
|
||||
expect(isCoreSkill("media-use")).toBe(true);
|
||||
expect(isCoreSkill("reverse-any-video")).toBe(true);
|
||||
expect(isCoreSkill("style-sampling")).toBe(true);
|
||||
// Decks, ports and optional integrations install on demand.
|
||||
expect(isCoreSkill("slideshow")).toBe(false);
|
||||
expect(isCoreSkill("remotion-to-hyperframes")).toBe(false);
|
||||
|
||||
@@ -111,17 +111,19 @@ const FETCH_TIMEOUT_MS = 4000;
|
||||
// structurally (sibling `../hyperframes/references/…` paths,
|
||||
// "call /media-use" preambles). These must be present and current
|
||||
// for any video work, so `init` / `skills update` keep them fresh.
|
||||
// on-demand — everything else: decks, Remotion ports, video rebuilds
|
||||
// (reverse-any-video, style-sampling) and optional integrations (figma).
|
||||
// They install when named (`hyperframes skills update <name>`),
|
||||
// So are the video rebuilds, which only trigger when installed.
|
||||
// on-demand — everything else: decks, Remotion ports and optional integrations
|
||||
// (figma). They install when named (`hyperframes skills update <name>`),
|
||||
// instead of being sprayed onto every machine that runs `init`.
|
||||
|
||||
/** The entry skill — read first for any video request. */
|
||||
const ENTRY_SKILL = "hyperframes";
|
||||
|
||||
/** True for skills every other skill depends on (see "Skill tiers" above). */
|
||||
const NAMED_CORE_SKILLS = new Set(["media-use", "reverse-any-video", "style-sampling"]);
|
||||
|
||||
/** True for skills every machine gets with `init` / `skills update` (see "Skill tiers" above). */
|
||||
export function isCoreSkill(name: string): boolean {
|
||||
return name === ENTRY_SKILL || name.startsWith("hyperframes-") || name === "media-use";
|
||||
return name === ENTRY_SKILL || name.startsWith("hyperframes-") || NAMED_CORE_SKILLS.has(name);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -138,6 +140,8 @@ export const FALLBACK_CORE_SKILLS: readonly string[] = [
|
||||
"hyperframes-cli",
|
||||
"hyperframes-registry",
|
||||
"media-use",
|
||||
"reverse-any-video",
|
||||
"style-sampling",
|
||||
];
|
||||
|
||||
/**
|
||||
|
||||
@@ -13,7 +13,8 @@ const REPO_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
|
||||
export const DESCRIPTION_MAX = 320;
|
||||
// Each budget carries +192 B for the usage beacon line (`beaconProblems`).
|
||||
export const CORE_SKILLS = {
|
||||
hyperframes: 7360,
|
||||
// +64 B for the routing rows to the video rebuilds, which only trigger when the entry hands them on.
|
||||
hyperframes: 7424,
|
||||
// +256 B for the `_meta.updateNotice` line: the agent relays it, the person updates.
|
||||
"hyperframes-cli": 7616,
|
||||
"hyperframes-registry": 5312,
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
"files": 2
|
||||
},
|
||||
"hyperframes": {
|
||||
"hash": "5100eacf7dc137af",
|
||||
"hash": "821c3faf498c1ecf",
|
||||
"files": 78
|
||||
},
|
||||
"hyperframes-cli": {
|
||||
@@ -26,7 +26,7 @@
|
||||
"files": 76
|
||||
},
|
||||
"reverse-any-video": {
|
||||
"hash": "f94599be483b10df",
|
||||
"hash": "80b5589967b49aea",
|
||||
"files": 5
|
||||
},
|
||||
"slideshow": {
|
||||
|
||||
@@ -61,6 +61,8 @@ Call it "the HyperFrames desktop app", never "Studio"; offer it as the better wa
|
||||
|
||||
| The request | Read |
|
||||
| --- | --- |
|
||||
| A video to copy or remake | `/reverse-any-video` |
|
||||
| An episode in a proven style | `/style-sampling` |
|
||||
| Launch, promo, feature | `references/types/launch.md` |
|
||||
| Explainer, tutorial | `references/types/explainer.md` |
|
||||
| Music video | `references/types/music.md` |
|
||||
@@ -73,4 +75,4 @@ Call it "the HyperFrames desktop app", never "Studio"; offer it as the better wa
|
||||
| Motion: eases, titles, cuts, punch-ins, speed, holds | `references/motion.md` |
|
||||
| Scenes, attributes, media, lint; GSAP, Lottie, 3D, canvas | `references/format.md`; `references/runtimes.md` |
|
||||
|
||||
Decks: `/slideshow`. Remotion source: `/remotion-to-hyperframes`. Copy a video: `/reverse-any-video`. Figma: `/figma`. Skills and the pinned CLI: `references/skill-lifecycle.md`.
|
||||
Decks: `/slideshow`. Remotion source: `/remotion-to-hyperframes`. Figma: `/figma`. Skills and the pinned CLI: `references/skill-lifecycle.md`.
|
||||
|
||||
@@ -4,8 +4,8 @@ Read this reference when the person asks about installing or updating skills, wh
|
||||
|
||||
For a plugin installation, follow [plugin execution rules](plugin-installation.md); the plugin manager owns updates and every skill is bundled. The commands below apply only to standalone skills.
|
||||
|
||||
- **Core set:** `/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
|
||||
- **On demand:** `/figma`, `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video` and `/style-sampling`, which the person installs with `npx hyperframes skills update <name>`.
|
||||
- **Core set:** `/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry`, `/media-use`, `/reverse-any-video` and `/style-sampling`.
|
||||
- **On demand:** `/figma`, `/slideshow` and `/remotion-to-hyperframes`, which the person installs with `npx hyperframes skills update <name>`.
|
||||
|
||||
## What `init` does
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: reverse-any-video
|
||||
description: Rebuild any video file as an editable HyperFrames project - motion graphics, talking heads, live action or AI-generated footage. Measure and watch it, rebuild every layer, then check the render against the original frame by frame. Use to reverse, recreate, replicate or copy a video.
|
||||
description: Rebuild any video file as an editable HyperFrames project - motion graphics, talking heads, live action or AI-generated footage - checked against the original frame by frame. Use to reverse, recreate, remake, replicate or copy a video, or 「复刻这个视频」「照着做一个」.
|
||||
---
|
||||
|
||||
**Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
|
||||
|
||||
Reference in New Issue
Block a user