diff --git a/README.md b/README.md
index 6fdc50855..402ef6655 100644
--- a/README.md
+++ b/README.md
@@ -130,12 +130,12 @@ npx skills add heygen-com/hyperframes    # HyperFrames skills
 npx skills add greensock/gsap-skills     # GSAP animation skills
 ```
 
-| Skill                                             | What it teaches                                                        |
-| ------------------------------------------------- | ---------------------------------------------------------------------- |
-| `hyperframes-compose`                             | HTML composition structure, `data-*` attributes, timeline registration |
-| `hyperframes-captions`                            | Caption/subtitle authoring and transcript integration                  |
-| `hyperframes-registry`                            | Block and component installation via `hyperframes add`                 |
-| `gsap-core`, `gsap-timeline`, `gsap-plugins`, ... | GSAP animation API, sequencing, ScrollTrigger, performance             |
+| Skill                  | What it teaches                                                                              |
+| ---------------------- | -------------------------------------------------------------------------------------------- |
+| `hyperframes`          | HTML composition authoring, captions, TTS, audio-reactive animation, transitions             |
+| `hyperframes-cli`      | CLI commands: init, lint, preview, render, transcribe, tts, doctor                           |
+| `hyperframes-registry` | Block and component installation via `hyperframes add`                                       |
+| `gsap`                 | GSAP animation API, timelines, easing, ScrollTrigger, plugins, React/Vue/Svelte, performance |
 
 ## Contributing
 
diff --git a/packages/cli/src/commands/contrast-audit.browser.js b/packages/cli/src/commands/contrast-audit.browser.js
index aa1e2128c..db506cc14 100644
--- a/packages/cli/src/commands/contrast-audit.browser.js
+++ b/packages/cli/src/commands/contrast-audit.browser.js
@@ -3,7 +3,7 @@
 // esbuild mangling (page.evaluate serializes functions; __name helpers break).
 //
 // NOTE: WCAG math (relLum, wcagRatio, parseColor, median) is duplicated in
-// skills/hyperframes-contrast/scripts/contrast-report.mjs — keep in sync.
+// skills/hyperframes/scripts/contrast-report.mjs — keep in sync.
 
 /* eslint-disable */
 window.__contrastAudit = async function (imgBase64, time) {
diff --git a/skills/hyperframes/SKILL.md b/skills/hyperframes/SKILL.md
index b4f9487eb..4f6821c2e 100644
--- a/skills/hyperframes/SKILL.md
+++ b/skills/hyperframes/SKILL.md
@@ -285,7 +285,7 @@ Use `--no-contrast` to skip if iterating rapidly and you'll check later.
 After authoring animations, run the animation map to verify choreography:
 
 ```bash
-node skills/hyperframes-animation-map/scripts/animation-map.mjs <composition-dir> \
+node skills/hyperframes/scripts/animation-map.mjs <composition-dir> \
   --out <composition-dir>/.hyperframes/anim-map
 ```
 
diff --git a/skills/hyperframes-animation-map/scripts/animation-map.mjs b/skills/hyperframes/scripts/animation-map.mjs
similarity index 99%
rename from skills/hyperframes-animation-map/scripts/animation-map.mjs
rename to skills/hyperframes/scripts/animation-map.mjs
index feeecf80b..55a96607c 100644
--- a/skills/hyperframes-animation-map/scripts/animation-map.mjs
+++ b/skills/hyperframes/scripts/animation-map.mjs
@@ -6,7 +6,7 @@
 // human-readable summaries. Outputs a single animation-map.json.
 //
 // Usage:
-//   node skills/hyperframes-animation-map/scripts/animation-map.mjs <composition-dir> \
+//   node skills/hyperframes/scripts/animation-map.mjs <composition-dir> \
 //     [--frames N] [--out <dir>] [--min-duration S] [--width W] [--height H] [--fps N]
 
 import { mkdir, writeFile } from "node:fs/promises";
diff --git a/skills/hyperframes-contrast/scripts/contrast-report.mjs b/skills/hyperframes/scripts/contrast-report.mjs
similarity index 99%
rename from skills/hyperframes-contrast/scripts/contrast-report.mjs
rename to skills/hyperframes/scripts/contrast-report.mjs
index 121500e41..63fa6259c 100644
--- a/skills/hyperframes-contrast/scripts/contrast-report.mjs
+++ b/skills/hyperframes/scripts/contrast-report.mjs
@@ -9,7 +9,7 @@
 //   - contrast-overlay.png  (sprite grid; magenta=fail AA, yellow=pass AA only, green=AAA)
 //
 // Usage:
-//   node skills/hyperframes-contrast/scripts/contrast-report.mjs <composition-dir> \
+//   node skills/hyperframes/scripts/contrast-report.mjs <composition-dir> \
 //     [--samples N] [--out <dir>] [--width W] [--height H] [--fps N]
 //
 // The composition directory must contain an index.html. Raw authoring HTML