Skip to content

Commit 9ec75a4

Browse files
docs: drop --full-depth from skills install commands (#3399)
* Update skills.mdx * docs: drop --full-depth from skills install commands
1 parent 254de3d commit 9ec75a4

8 files changed

Lines changed: 20 additions & 20 deletions

File tree

‎AGENTS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@ Open-source video rendering framework: write HTML, render video.
77
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** — the `/hyperframes` router installs each creation workflow on demand; install everything only when the user explicitly asks for the full set.
88

99
```bash
10-
npx hyperframes skills update # default: installs/refreshes the core set — workflows install on demand
11-
npx skills add heygen-com/hyperframes --full-depth # interactive picker (terminal only — non-interactive without --skill installs everything)
10+
npx hyperframes skills update # default: installs/refreshes the core set — workflows install on demand
11+
npx skills add heygen-com/hyperframes # interactive picker (terminal only — non-interactive without --skill installs everything)
1212
```
1313

1414
**Creation workflows** route through one entry skill — read `/hyperframes` first: it orients you to the whole surface, confirms the brief up front (the intent layer), and maps "make me a…" intent — usually a video, but also a navigable deck (`/slideshow`) or a composition port (`/remotion-to-hyperframes`) — to a concrete workflow. Consult it before invoking a specific workflow:

‎CLAUDE.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ Open-source video rendering framework: write HTML, render video.
77
This repo ships 20 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**: the `/hyperframes` router installs each creation workflow on demand; install all 20 only when the user explicitly asks for the full set.
88

99
```bash
10-
npx hyperframes skills update # default: installs/refreshes the core set — workflows install on demand
11-
npx skills add heygen-com/hyperframes --full-depth # interactive picker (terminal only — non-interactive without --skill installs all 20)
12-
npx skills add heygen-com/hyperframes --all --full-depth # all 20 at once — only on explicit request
13-
npx skills add heygen-com/hyperframes --skill <name> --full-depth # just one (bare name, no leading slash)
10+
npx hyperframes skills update # default: installs/refreshes the core set — workflows install on demand
11+
npx skills add heygen-com/hyperframes # interactive picker (terminal only — non-interactive without --skill installs all 20)
12+
npx skills add heygen-com/hyperframes --all # all 20 at once — only on explicit request
13+
npx skills add heygen-com/hyperframes --skill <name> # just one (bare name, no leading slash)
1414
```
1515

16-
Keep `--full-depth`: it installs the current `main`. Without it, `skills add` fetches the skills.sh registry blob, which lags `main` by hours (you'd get a stale skill). `hyperframes skills update` already uses full-depth.
16+
`skills add` resolves the skills.sh registry blob, which can lag `main` by hours, so a freshly added skill may be a little behind. `npx hyperframes skills update` installs from the current `main`; prefer it when freshness matters.
1717

1818
**`/hyperframes` is the entry skill — read it first.** It's the capability map for the domain skills below, the intent layer that confirms every creation brief up front, AND the intent router for the creation workflows. The full README skills section mirrors this list; keep them in sync (see "Skill catalog maintenance" below).
1919

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,12 @@ HyperFrames is an open-source framework for turning HTML, CSS, media, and seekab
3838
Install the HyperFrames skills, then describe the video you want:
3939

4040
```bash
41-
npx skills add heygen-com/hyperframes --full-depth
41+
npx skills add heygen-com/hyperframes
4242
```
4343

4444
> The picker opens with nothing pre-selected — the **Core Skills** group is all you need: the `/hyperframes` router installs each creation workflow on demand. Agents and non-interactive runs should use `npx hyperframes skills update` instead — it installs exactly the core set, whereas a non-interactive `skills add` without `--skill` installs all 20.
4545
>
46-
> `--full-depth` does a full clone of the repo's current `main`. Without it, `skills add` fetches the skills.sh registry blob, which lags `main` by hours — you'd get an older copy of a skill. (`hyperframes skills update` already installs full-depth.)
46+
> `skills add` resolves the skills.sh registry blob, which can lag `main` by hours. `npx hyperframes skills update` installs from the current `main`, so reach for it when you need the newest copy of a skill.
4747
4848
Try a prompt like:
4949

@@ -55,7 +55,7 @@ The skills teach agents the HyperFrames production loop: plan the video, write v
5555

5656
HyperFrames ships 20 skills agents load on demand. Read `/hyperframes` first — it's the router and capability map; it picks a workflow for any "make me a…" request — video, deck, or composition port — and points to the domain skills below.
5757

58-
Default to the **core set** — the router installs each creation workflow on demand. `npx hyperframes skills update` installs exactly that from anywhere; the interactive picker (`npx skills add heygen-com/hyperframes --full-depth`) 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 20. Use `npx skills add heygen-com/hyperframes --all --full-depth` to install all 20 deliberately (skips the picker), or `npx skills add heygen-com/hyperframes --skill <name> --full-depth` for just one (bare name, no leading `/`). Keep `--full-depth` — it installs the current `main`; without it `skills add` fetches the skills.sh blob, which lags by hours.
58+
Default to the **core set** — the router installs each creation workflow on demand. `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 20. Use `npx skills add heygen-com/hyperframes --all` to install all 20 deliberately (skips the picker), or `npx skills add heygen-com/hyperframes --skill <name>` for just one (bare name, no leading `/`).
5959

6060
Installs stay lean after that: `npx hyperframes init` keeps the **core set** fresh (the router, the `hyperframes-*` domain skills, and `media-use` — plus whatever is already installed; `/figma` stays on demand) and never expands a partial install; the creation workflows install **on demand** — the router runs `npx hyperframes skills update <workflow>` before entering one. Nothing re-pulls the full set behind your back.
6161

‎docs/guides/hyperframes-vs-remotion.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ And Apache 2.0 means no seat count and no license review.
142142
There is a real migration path, not a promise. Install the skill:
143143

144144
```bash
145-
npx skills add heygen-com/hyperframes --skill remotion-to-hyperframes --full-depth
145+
npx skills add heygen-com/hyperframes --skill remotion-to-hyperframes
146146
```
147147

148148
Then ask your agent to port the composition. It maps `useCurrentFrame` and

‎docs/guides/skills.mdx‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ framework's rules.
2323
Run the interactive installer:
2424

2525
```bash
26-
npx skills add heygen-com/hyperframes --full-depth
26+
npx skills add heygen-com/hyperframes
2727
```
2828

2929
Select **Core Skills**. The `/hyperframes` router installs a specialized creation workflow when the request needs one, so you do not need the full catalog up front.
@@ -57,7 +57,7 @@ npx hyperframes skills update pr-to-video
5757
Install the skills from the root of the project you open in Antigravity:
5858

5959
```bash
60-
npx skills add heygen-com/hyperframes --full-depth
60+
npx skills add heygen-com/hyperframes
6161
```
6262

6363
Select **Core Skills** and **Antigravity**. This uses Antigravity's supported
@@ -113,13 +113,13 @@ You can invoke a workflow directly when you already know it is the right one, bu
113113
Install the complete set deliberately with:
114114

115115
```bash
116-
npx skills add heygen-com/hyperframes --all --full-depth
116+
npx skills add heygen-com/hyperframes --all
117117
```
118118

119119
Or install one named skill:
120120

121121
```bash
122-
npx skills add heygen-com/hyperframes --skill hyperframes-animation --full-depth
122+
npx skills add heygen-com/hyperframes --skill hyperframes-animation
123123
```
124124

125125
Use the full set for an environment that must work across many HyperFrames tasks without fetching later. For a normal project, the core set is smaller and easier to keep current.

‎docs/packages/cli.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1172,7 +1172,7 @@ variable.
11721172
If you called the upstream command directly instead, set it yourself:
11731173

11741174
```bash
1175-
GIT_CLONE_PROTECTION_ACTIVE=0 npx skills add heygen-com/hyperframes --full-depth
1175+
GIT_CLONE_PROTECTION_ACTIVE=0 npx skills add heygen-com/hyperframes
11761176
```
11771177

11781178
### `figma` and `events`

‎docs/prompting/overview.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ The guide is one arc, novice to advanced. Each level is what you can do once you
3737
Install the skills in your project (or globally for your agent):
3838

3939
```bash
40-
npx skills add heygen-com/hyperframes --full-depth
40+
npx skills add heygen-com/hyperframes
4141
```
4242

4343
The installer shows a picker. Select the **core skills** below — every project needs them. In Claude Code, restart the session after installing; the skills register as **slash commands**. Start at `/hyperframes`: it orients you to the whole surface and routes "make me a video" requests to the right workflow.
@@ -72,7 +72,7 @@ The installer shows a picker. Select the **core skills** below — every project
7272
| `/figma` | A Figma file / frame / URL → imported assets, brand tokens, and reconstructed motion |
7373

7474
<Tip>
75-
To skip the picker and install everything (core + every workflow) in one shot, run `npx skills add heygen-com/hyperframes --all --full-depth`. And start HyperFrames prompts with `/hyperframes` (or invoke the skill another way for non-Claude agents) — it loads the routing + composition context explicitly so the agent picks the right workflow and gets the rules right the first time.
75+
To skip the picker and install everything (core + every workflow) in one shot, run `npx skills add heygen-com/hyperframes --all`. And start HyperFrames prompts with `/hyperframes` (or invoke the skill another way for non-Claude agents) — it loads the routing + composition context explicitly so the agent picks the right workflow and gets the rules right the first time.
7676
</Tip>
7777

7878

‎docs/quickstart.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,10 +42,10 @@ below is the same thing done by hand, if you would rather see each step.
4242
Run this in your project folder:
4343

4444
```bash
45-
npx skills add heygen-com/hyperframes --full-depth
45+
npx skills add heygen-com/hyperframes
4646
```
4747

48-
Choose **Core Skills** in the picker. Keep `--full-depth` so the installer uses the current repository version. Then open or restart your coding agent in that folder.
48+
Choose **Core Skills** in the picker. Then open or restart your coding agent in that folder.
4949

5050
## 2. Ask for the video
5151

0 commit comments

Comments
 (0)