You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 6857bb0
Browse filesBrowse the repository at this point in the historyBrowse files
docs(skills): stop directing the agent to install, update or remove skills (#7102)
A third-party skill-trust grader (DeltaVerdict D5) fails any skill text
that has the agent modify its own skills, even when disclosed or gated on
the user. Reword the skill lifecycle, plugin, CLI and scaffold text so it
states facts the agent can relay (skills are versioned with the CLI; the
person installs and updates them, and which command does it) instead of
commands for the agent to run. Every agent-run `init` example passes
--skip-skills, since init otherwise installs missing core skills; the
plugin header, plugin-cli and sfx messages are person-addressed; the
person's install commands are marked as theirs; /style-sampling joins
the on-demand lists. Regenerate skills-manifest.json and update the
pinned reverse init regex.
Co-authored-by: Claude Opus 5.5 <[email protected]>
Copy file name to clipboardExpand all lines: skills/figma/SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ name: figma
3
3
description: Bring Figma into a HyperFrames video - rendered assets, brand tokens, components, storyboard frames as reconstructed motion (frames read as states, not slides), 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.
4
4
---
5
5
6
-
**Plugin installs:**Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+
**Plugin installs:**Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
Copy file name to clipboardExpand all lines: skills/hyperframes-cli/SKILL.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ name: hyperframes-cli
3
3
description: 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.
4
4
---
5
5
6
-
**Plugin installs:**Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+
**Plugin installs:**Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
8
8
# HyperFrames CLI
9
9
@@ -15,7 +15,7 @@ A `--json` result may carry `_meta.updateNotice`: a newer HyperFrames release is
15
15
16
16
| Job | Commands |
17
17
| --- | --- |
18
-
| Start |`init <dir>` (blank; `--example <name>` only when asked), `capture <url>`|
18
+
| Start |`init <dir> --skip-skills` (blank; `--example <name>` only when asked), `capture <url>`|
19
19
| Read a project |`info`, `compositions`, `timeline --json`, `docs <topic>`|
20
20
| Check it |`lint` while writing; `check --json` as the gate (lint, runtime, layout, contrast) |
21
21
| Look at it |`snapshot` (`--at <t,…>`, `--range START,END`, `--composition <id>`, `--zoom`, `--angle`, `--against <video>`), `keyframes`, `compare`, `audio`|
@@ -24,7 +24,7 @@ A `--json` result may carry `_meta.updateNotice`: a newer HyperFrames release is
24
24
| Media and sound |`media-treatment`, `grade-compare`, `remove-background`, `tts`, `transcribe`, `beats`, `normalize-audio` (`/media-use`) |
25
25
| Show and ship |`preview`, `present` (`/slideshow`), `render`, `publish`, `cloud`, `lambda`, `cloudrun`|
Scaffolding commands. Use these instead of creating files by hand — they set up the right file structure, copy media, run transcription, and install AI coding skills.
5
+
Scaffolding commands. Use these instead of creating files by hand — they set up the right file structure, copy media, and run transcription.
npx hyperframes init my-video --skip-skills --non-interactive # CI — flag-only, same blank
17
17
```
18
18
19
19
**Default depends on TTY**: in a terminal, the CLI prompts for example/options (default: centered blank). Outside a TTY (CI, agents, piped output) it auto-switches to non-interactive and scaffolds that blank. Pass `--example` only to start from a named example. Pass `--non-interactive` to force flag-only mode on a TTY.
-`--skill=<slug>` — record the owning skill (e.g. `hyperframes`) in `hyperframes.json`, so every later render of this project — re-renders, `npm run render`, `--batch` — is attributed to it on usage telemetry without re-passing the flag. You rarely pass it by hand.
27
-
-`--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same.
27
+
-`--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same. Always pass it: without it `init` installs any missing core skill, and installing skills is the person's step. When a core skill is missing, tell the person they can install it with `npx hyperframes skills update`.
28
28
-`--skip-transcribe` — don't auto-transcribe `--audio` / `--video` with Whisper.
29
29
-`--model`, `--language` — Whisper model / language for the auto-transcription.
30
30
@@ -72,8 +72,4 @@ into a fresh output directory; never merge or reuse a blocked attempt's partial
72
72
73
73
## skills
74
74
75
-
```bash
76
-
npx hyperframes skills # install HyperFrames skills for AI coding tools
77
-
```
78
-
79
-
One-time setup that adds the HyperFrames skill pack (/hyperframes with its references, /hyperframes-cli, /hyperframes-registry, /media-use, /figma, /slideshow, /remotion-to-hyperframes, /reverse-any-video) to the local AI coding environment so agents follow the framework conventions. Re-run after major HyperFrames upgrades.
75
+
`npx hyperframes skills` is the person's one-time setup: it adds the HyperFrames skill pack (/hyperframes with its references, /hyperframes-cli, /hyperframes-registry, /media-use, /figma, /slideshow, /remotion-to-hyperframes, /reverse-any-video, /style-sampling) to the local AI coding environment so agents follow the framework conventions. Skills are versioned with the CLI; after a HyperFrames upgrade the person can refresh them with `npx hyperframes skills update`. Tell them when that applies; do not run it yourself.
Copy file name to clipboardExpand all lines: skills/hyperframes-registry/SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ name: hyperframes-registry
3
3
description: About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
4
4
---
5
5
6
-
**Plugin installs:**Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+
**Plugin installs:**Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
Copy file name to clipboardExpand all lines: skills/hyperframes/SKILL.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,13 +3,13 @@ name: hyperframes
3
3
description: Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
4
4
---
5
5
6
-
**Plugin installs:**Before setup or freshness commands, follow [plugin execution rules](references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+
**Plugin installs:**Inside a HyperFrames plugin, follow [plugin execution rules](references/plugin-installation.md).
7
7
8
8
# HyperFrames
9
9
10
10
HyperFrames renders HTML to video by seeking a paused timeline frame by frame, so every render is identical; the person edits the same files in the Studio preview. Use it unless another framework or a plain browser recording is asked for. Run the CLI as `npx hyperframes <command>` (`/hyperframes-cli`); at the start of a new video, `npx hyperframes usage --json` reports the person's remaining plan usage (say "unknown" when it is).
11
11
12
-
`index.html` is the root composition: it declares the video's variables and mounts one scene per sub-composition from `compositions/`. Media and fonts live in `assets/`. A new project: `npx hyperframes init <dir>`. A website as the subject: `npx hyperframes capture <url> --json`.
12
+
`index.html` is the root composition: it declares the video's variables and mounts one scene per sub-composition from `compositions/`. Media and fonts live in `assets/`. A new project: `npx hyperframes init <dir> --skip-skills`. A website as the subject: `npx hyperframes capture <url> --json`.
13
13
14
14
Build what was asked: no voiceover or captions and no new aspect ratio unless the request or the source calls for them; a film over ~15 s that tells something gets music and sound on its visible actions unless the person asked for silence (`references/sound.md`). A new video is 1920×1080 at 30 fps. A question, a hold or a loose idea gets an answer or a proposal, not an edit. Before hand-writing a named effect, transition, caption style, chart or card, search the registry (`/hyperframes-registry`). Any media (a presenter or avatar, footage, voice, music): `/media-use`, which says when HeyGen is needed and what is free. Show real things from their source (the product's screens, the brand's logo, a real place's imagery); draw only what has none.
Copy file name to clipboardExpand all lines: skills/hyperframes/references/plugin-installation.md
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,11 +3,10 @@
3
3
Check the directory two levels above the loaded `SKILL.md` for `plugin.json`,
4
4
`.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, or
5
5
`.cursor-plugin/plugin.json` identifying `hyperframes`, or a Gemini extension manifest.
6
-
That directory is `<PLUGIN_ROOT>`. If none exists, this is a standalone skill;
7
-
follow the normal installation and freshness instructions.
6
+
That directory is `<PLUGIN_ROOT>`. If none exists, this is a standalone skill
7
+
install; run `npx hyperframes` directly.
8
8
9
-
For a plugin installation, these rules replace the standalone update commands
10
-
in every skill and reference:
9
+
For a plugin installation, these rules apply in every skill and reference:
11
10
12
11
- Do not run `hyperframes skills update`, `skills check`, or `npx skills add`.
13
12
The agent's plugin manager owns installation and updates. Read the skill at
@@ -37,7 +36,7 @@ in every skill and reference:
37
36
project or a temporary directory. Pass this plugin root and launcher convention
38
37
to any delegated agent so it does not fall back to global skills.
39
38
40
-
To get newer skills, use the client's plugin update flow and reload the session.
41
-
Do not silently update an installed plugin during a video task.
39
+
Newer skills come through the client's plugin update flow and a session reload,
40
+
which the person runs. Do not update an installed plugin yourself.
42
41
43
42
The launcher suppresses CLI update notices as well as standalone skill refreshes, including when running an older CLI with a stale notice cache. It passes the release as `HYPERFRAMES_PLUGIN_VERSION` for plugin-aware helpers and as `HYPERFRAMES_SKILL_PKG_VERSION` for the existing helper-package bootstrap. Our release process versions those packages together.
Copy file name to clipboardExpand all lines: skills/hyperframes/references/skill-lifecycle.md
+15-10Lines changed: 15 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,15 @@
1
1
# Skill installation and freshness
2
2
3
-
Read this reference when installing or updating skills, diagnosing unexpected skill behavior, or running HyperFrames setup in CI.
3
+
Read this reference when the person asks about installing or updating skills, when diagnosing unexpected skill behavior, or when setting up HyperFrames in CI (see `HYPERFRAMES_SKIP_SKILLS` below). Skills are versioned with the CLI. Installing, updating and removing them is the person's step: tell them what is out of date and which command fits, and do not run it yourself.
4
4
5
5
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.
6
6
7
-
-**Core set, installed eagerly:**`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
8
-
-**On demand:**`/figma`, `/slideshow`, `/remotion-to-hyperframes` and `/reverse-any-video`, installed with `npx hyperframes skills update <name>`.
7
+
-**Core set:**`/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
8
+
-**On demand:**`/figma`, `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video` and `/style-sampling`, which the person installs with `npx hyperframes skills update <name>`.
9
9
10
10
## What `init` does
11
11
12
-
`npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Updating is `npx hyperframes skills update`, run by you. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
12
+
Without `--skip-skills`, `npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Installing the core set is the person's step, so pass `--skip-skills` whenever you run `init`. When a core skill is missing, tell the person to run `npx hyperframes skills update`, which also updates the skills already installed. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
13
13
14
14
`--skip-skills` makes `init` leave skills alone. `HYPERFRAMES_SKIP_SKILLS=1` does the same for CI and tests.
15
15
@@ -19,24 +19,29 @@ For a plugin installation, follow [plugin execution rules](plugin-installation.m
19
19
20
20
After `render`, `lint` and `validate`, the CLI prints `N HyperFrames skills out of date or missing` to stderr when the cached check finds stale skills, so an agent run without a terminal sees it too. It is off in CI, in dev, with `HYPERFRAMES_NO_UPDATE_CHECK=1` and with `HYPERFRAMES_SKIP_SKILLS=1`, and runs with `--json` too, since it only writes stderr and leaves `--json` stdout untouched.
21
21
22
-
## Diagnose and update
22
+
## Diagnose, and what the person can run
23
23
24
24
```bash
25
25
npx hyperframes skills check
26
26
npx hyperframes skills check --json
27
-
npx hyperframes skills update
28
-
npx hyperframes skills update <name>
29
-
npx hyperframes skills
27
+
```
28
+
29
+
The person's install and update commands, to name when you relay a stale result:
30
+
31
+
```bash
32
+
npx hyperframes skills update # the person runs this
33
+
npx hyperframes skills update <name># the person runs this
34
+
npx hyperframes skills # the person runs this
30
35
```
31
36
32
37
-`skills check` exits non-zero when an installed skill is stale or the core set is incomplete. Skills available on demand but not installed are not failures.
33
38
- Bare `skills update` refreshes the core set and the HyperFrames skills already installed. It never removes a skill, and it leaves a skill the install record attributes to another publisher alone, even when the name matches one of ours.
34
39
- Named `skills update <name...>` also installs those named skills.
35
40
- Bare `skills` installs the full published set explicitly.
36
41
37
-
If the HyperFrames CLI is unavailable, use`npx skills add heygen-com/hyperframes --skill <name>` for one skill or `npx skills add heygen-com/hyperframes --all` for the full published set.
42
+
If the HyperFrames CLI is unavailable, the person can install with`npx skills add heygen-com/hyperframes --skill <name>` for one skill or `npx skills add heygen-com/hyperframes --all` for the full published set.
38
43
39
-
The CLI may print a one-line stale-skill reminder during `render`, `lint`, or `check`. Treat a failed update as a visible tool failure; do not continue from a remembered skill.
44
+
The CLI may print a one-line stale-skill reminder during `render`, `lint`, or `check`. Relay it to the person and keep working from the installed skills; do not continue from a remembered skill.
0 commit comments