hyperframes 0.1.6 → 0.1.8

package/dist/cli.js

@@ -422,7 +422,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.1.6" : "0.0.0-dev";
+    VERSION = true ? "0.1.8" : "0.0.0-dev";
   }
 });
 
@@ -2748,6 +2748,25 @@ import { existsSync as existsSync3, mkdirSync as mkdirSync3, readdirSync, rmSync
 import { join as join3, dirname } from "path";
 import { homedir as homedir3 } from "os";
 import { execFileSync as execFileSync2 } from "child_process";
+function hasNpx() {
+  try {
+    execFileSync2("npx", ["--version"], { stdio: "ignore", timeout: 5e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runSkillsAdd(repo, agents, global) {
+  const args = ["skills", "add", repo, "-y"];
+  if (global) args.push("-g");
+  for (const agent of agents) {
+    args.push("-a", agent);
+  }
+  execFileSync2("npx", args, {
+    stdio: "ignore",
+    timeout: 12e4
+  });
+}
 function hasGit2() {
   try {
     execFileSync2("git", ["--version"], { stdio: "ignore", timeout: 5e3 });
@@ -2764,6 +2783,7 @@ function gitClone(repo, dest) {
   });
 }
 function fetchRepo(source) {
+  const gitUrl = `https://github.com/${source.repo}.git`;
   if (existsSync3(source.cache)) {
     try {
       execFileSync2("git", ["pull", "--ff-only"], {
@@ -2773,18 +2793,17 @@ function fetchRepo(source) {
         env: GIT_ENV
       });
     } catch {
-      const skillsDir = join3(source.cache, source.skillsPath);
-      if (existsSync3(skillsDir)) {
-        return skillsDir;
-      }
+      const skillsDir2 = join3(source.cache, source.skillsPath);
+      if (existsSync3(skillsDir2)) return skillsDir2;
       rmSync2(source.cache, { recursive: true, force: true });
-      gitClone(source.repo, source.cache);
+      gitClone(gitUrl, source.cache);
     }
   } else {
     mkdirSync3(dirname(source.cache), { recursive: true });
-    gitClone(source.repo, source.cache);
+    gitClone(gitUrl, source.cache);
   }
-  return join3(source.cache, source.skillsPath);
+  const skillsDir = join3(source.cache, source.skillsPath);
+  return existsSync3(skillsDir) ? skillsDir : void 0;
 }
 function installSkillsFromDir(sourceDir, targetDir, sourceName) {
   const installed = [];
@@ -2795,24 +2814,20 @@ function installSkillsFromDir(sourceDir, targetDir, sourceName) {
     const skillFile = join3(sourceDir, entry.name, "SKILL.md");
     if (!existsSync3(skillFile)) continue;
     const destDir = join3(targetDir, entry.name);
-    const overwritten = existsSync3(destDir);
-    if (overwritten) rmSync2(destDir, { recursive: true, force: true });
+    if (existsSync3(destDir)) rmSync2(destDir, { recursive: true, force: true });
     mkdirSync3(destDir, { recursive: true });
     cpSync(join3(sourceDir, entry.name), destDir, { recursive: true });
-    installed.push({ name: entry.name, source: sourceName, overwritten });
+    installed.push({ name: entry.name, source: sourceName });
   }
   return installed;
 }
-async function installAllSkills(targetNames) {
-  if (!hasGit2()) return { count: 0, targets: [], skipped: SOURCES.map((s) => s.name) };
-  const targets = targetNames ? TARGETS.filter((t2) => targetNames.includes(t2.flag)) : TARGETS.filter((t2) => t2.defaultEnabled);
-  let totalCount = 0;
+function fallbackInstall(targets) {
   const skipped = [];
   const fetched = [];
   for (const source of SOURCES) {
     try {
       const skillsDir = fetchRepo(source);
-      if (existsSync3(skillsDir)) {
+      if (skillsDir) {
         fetched.push({ source, skillsDir });
       } else {
         skipped.push(source.name);
@@ -2821,21 +2836,45 @@ async function installAllSkills(targetNames) {
       skipped.push(source.name);
     }
   }
-  const [firstTarget, ...remainingTargets] = targets;
-  if (firstTarget) {
-    mkdirSync3(firstTarget.dir, { recursive: true });
+  const [first, ...rest] = targets;
+  const allInstalled = [];
+  if (first) {
+    mkdirSync3(first.dir, { recursive: true });
     for (const { skillsDir, source } of fetched) {
-      const skills = installSkillsFromDir(skillsDir, firstTarget.dir, source.name);
-      totalCount += skills.length;
+      allInstalled.push(...installSkillsFromDir(skillsDir, first.dir, source.name));
     }
   }
-  for (const target of remainingTargets) {
+  for (const target of rest) {
     mkdirSync3(target.dir, { recursive: true });
     for (const { skillsDir, source } of fetched) {
       installSkillsFromDir(skillsDir, target.dir, source.name);
     }
   }
-  return { count: totalCount, targets: targets.map((t2) => t2.name), skipped };
+  return { count: allInstalled.length, installed: allInstalled, skipped };
+}
+async function installAllSkills(targetNames) {
+  const targets = targetNames ? TARGETS.filter((t2) => targetNames.includes(t2.flag)) : TARGETS.filter((t2) => t2.defaultEnabled);
+  const agents = targets.map((t2) => t2.skillsAgent);
+  if (hasNpx()) {
+    const skipped = [];
+    let count = 0;
+    for (const source of SOURCES) {
+      try {
+        runSkillsAdd(source.repo, agents, true);
+        count += 1;
+      } catch {
+        skipped.push(source.name);
+      }
+    }
+    if (count > 0) {
+      return { count, targets: targets.map((t2) => t2.name), skipped };
+    }
+  }
+  if (!hasGit2()) {
+    return { count: 0, targets: [], skipped: SOURCES.map((s) => s.name) };
+  }
+  const result = fallbackInstall(targets);
+  return { count: result.count, targets: targets.map((t2) => t2.name), skipped: result.skipped };
 }
 function resolveTargets(args) {
   const hasAnyFlag = TARGETS.some((t2) => args[t2.flag] === true);
@@ -2846,70 +2885,57 @@ function resolveTargets(args) {
 }
 async function runInstall({ args }) {
   Wt2(c.bold("hyperframes skills"));
-  if (!hasGit2()) {
-    R2.error(c.error("git is required to install skills. Install git and retry."));
-    Gt(c.warn("No skills installed."));
-    return;
-  }
   const targets = resolveTargets(args);
-  const fetched = [];
-  for (const source of SOURCES) {
-    const spinner = be();
-    spinner.start(`Fetching ${source.name} skills...`);
-    try {
-      const skillsDir = fetchRepo(source);
-      if (existsSync3(skillsDir)) {
-        fetched.push({ source, skillsDir });
-        spinner.stop(c.success(`${source.name} skills fetched`));
-      } else {
-        spinner.stop(c.warn(`${source.name}: no skills directory found`));
+  const agents = targets.map((t2) => t2.skillsAgent);
+  if (hasNpx()) {
+    const installed = [];
+    const skippedSources = [];
+    for (const source of SOURCES) {
+      const spinner = be();
+      spinner.start(`Installing ${source.name} skills...`);
+      try {
+        runSkillsAdd(source.repo, agents, true);
+        installed.push(source.name);
+        spinner.stop(c.success(`${source.name} skills installed`));
+      } catch {
+        skippedSources.push(source.name);
+        spinner.stop(c.dim(`${source.name} skills skipped (unavailable)`));
       }
-    } catch {
-      spinner.stop(c.dim(`${source.name} skills skipped (repo not accessible)`));
     }
-  }
-  const allInstalled = [];
-  let counted = false;
-  for (const target of targets) {
-    const spinner = be();
-    spinner.start(`Installing to ${target.name}...`);
-    mkdirSync3(target.dir, { recursive: true });
-    let count = 0;
-    for (const { source, skillsDir } of fetched) {
-      const skills = installSkillsFromDir(skillsDir, target.dir, source.name);
-      count += skills.length;
-      if (!counted) allInstalled.push(...skills);
+    console.log();
+    console.log(`   ${c.dim("Targets:")}  ${targets.map((t2) => t2.name).join(", ")}`);
+    if (skippedSources.length > 0) {
+      console.log(`   ${c.dim("Skipped:")}  ${skippedSources.join(", ")}`);
     }
-    counted = true;
-    spinner.stop(c.success(`${count} skills \u2192 ${target.name} ${c.dim(target.dir)}`));
+    console.log();
+    if (installed.length > 0) {
+      Gt(c.success(`${installed.join(" + ")} skills installed.`));
+      return;
+    }
+    R2.warn("npx skills add failed \u2014 trying fallback...");
+  }
+  if (!hasGit2()) {
+    R2.error(c.error("Neither npx nor git available. Install Node.js or git and retry."));
+    Gt(c.warn("No skills installed."));
+    return;
   }
+  R2.info(c.dim("Using git fallback..."));
+  const result = fallbackInstall(targets);
   console.log();
   for (const source of SOURCES) {
-    const names = allInstalled.filter((s) => s.source === source.name).map((s) => s.name);
+    const names = result.installed.filter((s) => s.source === source.name).map((s) => s.name);
     if (names.length > 0) {
       const label2 = `${source.name}:`.padEnd(14);
       console.log(`   ${c.dim(label2)} ${names.map((s) => c.accent(s)).join(", ")}`);
     }
   }
   console.log(`   ${c.dim("Targets:")}      ${targets.map((t2) => t2.name).join(", ")}`);
-  console.log();
-  const skippedSources = SOURCES.filter((s) => !fetched.some((f) => f.source.name === s.name));
-  if (skippedSources.length > 0) {
-    console.log(
-      `   ${c.dim("Skipped:")}      ${skippedSources.map((s) => s.name).join(", ")} (repo not accessible)`
-    );
+  if (result.skipped.length > 0) {
+    console.log(`   ${c.dim("Skipped:")}      ${result.skipped.join(", ")}`);
   }
   console.log();
-  if (allInstalled.length > 0 && skippedSources.length > 0) {
-    const readySources = fetched.map((f) => f.source.name).join(", ");
-    const skippedNames = skippedSources.map((s) => s.name).join(", ");
-    Gt(
-      c.warn(
-        `${allInstalled.length} skills ready (${readySources}). Unavailable: ${skippedNames}.`
-      )
-    );
-  } else if (allInstalled.length > 0) {
-    Gt(c.success(`${allInstalled.length} skills ready.`));
+  if (result.count > 0) {
+    Gt(c.success(`${result.count} skills ready.`));
   } else {
     Gt(c.warn("No skills installed."));
   }
@@ -2925,24 +2951,28 @@ var init_install_skills = __esm({
       {
         name: "Claude Code",
         flag: "claude",
+        skillsAgent: "claude-code",
         dir: join3(homedir3(), ".claude", "skills"),
         defaultEnabled: true
       },
       {
         name: "Gemini CLI",
         flag: "gemini",
+        skillsAgent: "gemini-cli",
         dir: join3(homedir3(), ".gemini", "skills"),
         defaultEnabled: true
       },
       {
         name: "Codex CLI",
         flag: "codex",
+        skillsAgent: "codex",
         dir: join3(homedir3(), ".codex", "skills"),
         defaultEnabled: true
       },
       {
         name: "Cursor",
         flag: "cursor",
+        skillsAgent: "cursor",
         get dir() {
           return join3(process.cwd(), ".cursor", "skills");
         },
@@ -2952,13 +2982,13 @@ var init_install_skills = __esm({
     SOURCES = [
       {
         name: "HyperFrames",
-        repo: "https://github.com/heygen-com/hyperframes.git",
+        repo: "heygen-com/hyperframes",
         skillsPath: "skills",
         cache: join3(homedir3(), ".cache", "hyperframes", "hyperframes-skills")
       },
       {
         name: "GSAP",
-        repo: "https://github.com/greensock/gsap-skills.git",
+        repo: "greensock/gsap-skills",
         skillsPath: "skills",
         cache: join3(homedir3(), ".cache", "hyperframes", "gsap-skills")
       }
@@ -3469,6 +3499,37 @@ function lintHyperframeHtml(html, options = {}) {
       fixHint: "Register each composition timeline on `window.__timelines[compositionId]`."
     });
   }
+  if (TIMELINE_REGISTRY_ASSIGN_PATTERN.test(source) && !TIMELINE_REGISTRY_INIT_PATTERN.test(source)) {
+    pushFinding({
+      code: "timeline_registry_missing_init",
+      severity: "error",
+      message: "`window.__timelines[\u2026] = \u2026` is used without initializing `window.__timelines` first.",
+      fixHint: "Add `window.__timelines = window.__timelines || {};` before any timeline assignment."
+    });
+  }
+  {
+    const htmlCompIds = /* @__PURE__ */ new Set();
+    const timelineRegKeys = /* @__PURE__ */ new Set();
+    const compIdRe = /data-composition-id\s*=\s*["']([^"']+)["']/gi;
+    const tlKeyRe = /window\.__timelines\[\s*["']([^"']+)["']\s*\]/g;
+    let m;
+    while ((m = compIdRe.exec(source)) !== null) {
+      if (m[1]) htmlCompIds.add(m[1]);
+    }
+    while ((m = tlKeyRe.exec(source)) !== null) {
+      if (m[1]) timelineRegKeys.add(m[1]);
+    }
+    for (const key2 of timelineRegKeys) {
+      if (!htmlCompIds.has(key2)) {
+        pushFinding({
+          code: "timeline_id_mismatch",
+          severity: "error",
+          message: `Timeline registered as "${key2}" but no element has data-composition-id="${key2}". The runtime cannot auto-nest this timeline.`,
+          fixHint: `Change window.__timelines["${key2}"] to match the data-composition-id attribute, or vice versa.`
+        });
+      }
+    }
+  }
   if (INVALID_SCRIPT_CLOSE_PATTERN.test(source)) {
     pushFinding({
       code: "invalid_inline_script_syntax",
@@ -23766,7 +23827,11 @@ __export(render_exports, {
   default: () => render_default
 });
 import { existsSync as existsSync24, mkdirSync as mkdirSync16, statSync as statSync9 } from "fs";
+import { cpus as cpus2 } from "os";
 import { resolve as resolve13, dirname as dirname12, join as join22 } from "path";
+function defaultWorkerCount() {
+  return Math.max(1, Math.min(Math.floor(CPU_CORE_COUNT / 2), 4));
+}
 async function renderDocker(projectDir, outputPath, options) {
   const producer = await loadProducer();
   const startTime = Date.now();
@@ -23780,7 +23845,11 @@ async function renderDocker(projectDir, outputPath, options) {
     });
     await producer.executeRenderJob(job, projectDir, outputPath);
   } catch (error) {
-    trackRenderError({ fps: options.fps, quality: options.quality, docker: true });
+    trackRenderError({
+      fps: options.fps,
+      quality: options.quality,
+      docker: true
+    });
     const message = error instanceof Error ? error.message : String(error);
     errorBox("Render failed", message, "Check Docker is running: docker info");
     process.exit(1);
@@ -23790,7 +23859,7 @@ async function renderDocker(projectDir, outputPath, options) {
     durationMs: elapsed,
     fps: options.fps,
     quality: options.quality,
-    workers: options.workers ?? 4,
+    workers: options.workers,
     docker: true,
     gpu: options.gpu
   });
@@ -23815,7 +23884,11 @@ async function renderLocal(projectDir, outputPath, options) {
   try {
     await producer.executeRenderJob(job, projectDir, outputPath, onProgress);
   } catch (error) {
-    trackRenderError({ fps: options.fps, quality: options.quality, docker: false });
+    trackRenderError({
+      fps: options.fps,
+      quality: options.quality,
+      docker: false
+    });
     const message = error instanceof Error ? error.message : String(error);
     errorBox("Render failed", message, "Try --docker for containerized rendering");
     process.exit(1);
@@ -23825,7 +23898,7 @@ async function renderLocal(projectDir, outputPath, options) {
     durationMs: elapsed,
     fps: options.fps,
     quality: options.quality,
-    workers: options.workers ?? 4,
+    workers: options.workers,
     docker: false,
     gpu: options.gpu
   });
@@ -23843,7 +23916,7 @@ function printRenderComplete(outputPath, elapsedMs, quiet) {
   console.log(c.success("\u25C7") + "  " + c.accent(outputPath));
   console.log("   " + c.bold(fileSize) + c.dim(" \xB7 " + duration + " \xB7 completed"));
 }
-var VALID_FPS, VALID_QUALITY, VALID_FORMAT, render_default;
+var VALID_FPS, VALID_QUALITY, VALID_FORMAT, CPU_CORE_COUNT, render_default;
 var init_render = __esm({
   "src/commands/render.ts"() {
     "use strict";
@@ -23857,6 +23930,7 @@ var init_render = __esm({
     VALID_FPS = /* @__PURE__ */ new Set([24, 30, 60]);
     VALID_QUALITY = /* @__PURE__ */ new Set(["draft", "standard", "high"]);
     VALID_FORMAT = /* @__PURE__ */ new Set(["mp4", "webm"]);
+    CPU_CORE_COUNT = cpus2().length;
     render_default = defineCommand({
       meta: {
         name: "render",
@@ -23869,19 +23943,45 @@ Examples:
   hyperframes render --docker --output deterministic.mp4`
       },
       args: {
-        dir: { type: "positional", description: "Project directory", required: false },
-        output: { type: "string", description: "Output path (default: renders/<name>.mp4)" },
-        fps: { type: "string", description: "Frame rate: 24, 30, 60", default: "30" },
-        quality: { type: "string", description: "Quality: draft, standard, high", default: "standard" },
+        dir: {
+          type: "positional",
+          description: "Project directory",
+          required: false
+        },
+        output: {
+          type: "string",
+          description: "Output path (default: renders/<name>.mp4)"
+        },
+        fps: {
+          type: "string",
+          description: "Frame rate: 24, 30, 60",
+          default: "30"
+        },
+        quality: {
+          type: "string",
+          description: "Quality: draft, standard, high",
+          default: "standard"
+        },
         format: {
           type: "string",
           description: "Output format: mp4, webm (WebM renders with transparency)",
           default: "mp4"
         },
-        workers: { type: "string", description: "Parallel workers 1-8" },
-        docker: { type: "boolean", description: "Use Docker for deterministic render", default: false },
+        workers: {
+          type: "string",
+          description: "Parallel render workers (1-8 or 'auto'). Default: half your CPU cores, max 4. Each worker launches a separate Chrome process."
+        },
+        docker: {
+          type: "boolean",
+          description: "Use Docker for deterministic render",
+          default: false
+        },
         gpu: { type: "boolean", description: "Use GPU encoding", default: false },
-        quiet: { type: "boolean", description: "Suppress verbose output", default: false }
+        quiet: {
+          type: "boolean",
+          description: "Suppress verbose output",
+          default: false
+        }
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
@@ -23904,10 +24004,10 @@ Examples:
         }
         const format = formatRaw;
         let workers;
-        if (args.workers != null) {
+        if (args.workers != null && args.workers !== "auto") {
           const parsed = parseInt(args.workers, 10);
           if (isNaN(parsed) || parsed < 1 || parsed > 8) {
-            errorBox("Invalid workers", `Got "${args.workers}". Must be between 1 and 8.`);
+            errorBox("Invalid workers", `Got "${args.workers}". Must be 1-8 or "auto".`);
             process.exit(1);
           }
           workers = parsed;
@@ -23915,22 +24015,18 @@ Examples:
         const rendersDir = resolve13("renders");
         const ext = format === "webm" ? ".webm" : ".mp4";
         const outputPath = args.output ? resolve13(args.output) : join22(rendersDir, `${project.name}${ext}`);
-        const outputDir = dirname12(outputPath);
-        if (!existsSync24(outputDir)) {
-          mkdirSync16(outputDir, { recursive: true });
-        }
+        mkdirSync16(dirname12(outputPath), { recursive: true });
         const useDocker = args.docker ?? false;
         const useGpu = args.gpu ?? false;
         const quiet = args.quiet ?? false;
-        const workerCount = workers ?? 4;
+        const workerCount = workers ?? defaultWorkerCount();
         if (!quiet) {
+          const workerLabel = args.workers != null ? `${workerCount} workers` : `${workerCount} workers (auto \u2014 half of ${CPU_CORE_COUNT} cores)`;
           console.log("");
           console.log(
             c.accent("\u25C6") + "  Rendering " + c.accent(project.name) + c.dim(" \u2192 " + outputPath)
           );
-          console.log(
-            c.dim("   " + fps + "fps \xB7 " + quality + " \xB7 " + workerCount + " workers")
-          );
+          console.log(c.dim("   " + fps + "fps \xB7 " + quality + " \xB7 " + workerLabel));
           console.log("");
         }
         if (!useDocker) {
@@ -23977,7 +24073,7 @@ Examples:
             fps,
             quality,
             format,
-            workers,
+            workers: workerCount,
             gpu: useGpu,
             quiet
           });
@@ -23986,7 +24082,7 @@ Examples:
             fps,
             quality,
             format,
-            workers,
+            workers: workerCount,
             gpu: useGpu,
             quiet,
             browserPath
@@ -24261,12 +24357,21 @@ function transcodeToMp4(inputPath, outputPath) {
     child.on("error", () => resolvePromise(false));
   });
 }
-function getStaticTemplateDir(templateId) {
-  const dir = dirname13(fileURLToPath5(import.meta.url));
-  const devPath = resolve14(dir, "..", "templates", templateId);
-  const builtPath = resolve14(dir, "templates", templateId);
+function resolveAssetDir(devSegments, builtSegments) {
+  const base = dirname13(fileURLToPath5(import.meta.url));
+  const devPath = resolve14(base, ...devSegments);
+  const builtPath = resolve14(base, ...builtSegments);
   return existsSync26(devPath) ? devPath : builtPath;
 }
+function getStaticTemplateDir(templateId) {
+  return resolveAssetDir(["..", "templates", templateId], ["templates", templateId]);
+}
+function getSharedTemplateDir() {
+  return resolveAssetDir(["..", "templates", "_shared"], ["templates", "_shared"]);
+}
+function getBundledSkillsDir() {
+  return resolveAssetDir(["..", "..", "..", "..", "skills"], ["skills"]);
+}
 function patchVideoSrc(dir, videoFilename, durationSeconds) {
   const htmlFiles = readdirSync7(dir, { withFileTypes: true, recursive: true }).filter((e) => e.isFile() && e.name.endsWith(".html")).map((e) => join24(e.parentPath ?? e.path, e.name));
   for (const file of htmlFiles) {
@@ -24417,6 +24522,28 @@ function scaffoldProject(destDir, name, templateId, localVideoName, durationSeco
     ),
     "utf-8"
   );
+  const sharedDir = getSharedTemplateDir();
+  if (existsSync26(sharedDir)) {
+    for (const entry of readdirSync7(sharedDir, { withFileTypes: true })) {
+      const src = join24(sharedDir, entry.name);
+      const dest = resolve14(destDir, entry.name);
+      if (entry.isFile() || entry.isSymbolicLink()) {
+        copyFileSync3(src, dest);
+      }
+    }
+  }
+  const skillsSrcDir = getBundledSkillsDir();
+  if (existsSync26(skillsSrcDir)) {
+    const projectSkills = ["compose-video", "captions"];
+    for (const skill of projectSkills) {
+      const src = join24(skillsSrcDir, skill);
+      if (existsSync26(src)) {
+        const dest = resolve14(destDir, ".claude", "skills", skill);
+        mkdirSync18(dest, { recursive: true });
+        cpSync2(src, dest, { recursive: true });
+      }
+    }
+  }
 }
 async function nextStepLoop(destDir) {
   while (true) {
@@ -24571,9 +24698,28 @@ Example: hyperframes init my-video --template blank --video video.mp4`);
             await installSkills(false);
           }
           console.log(c.success(`Created ${c.accent(name2 + "/")}`));
-          for (const f of readdirSync7(destDir2)) {
+          for (const f of readdirSync7(destDir2).filter((f2) => !f2.startsWith("."))) {
             console.log(`  ${c.accent(f)}`);
           }
+          console.log();
+          console.log("Next steps:");
+          console.log(
+            `  ${c.accent(`cd ${name2}`)} && ${c.accent("npx hyperframes dev")}      ${c.dim("# preview in studio")}`
+          );
+          console.log(
+            `  ${c.accent(`cd ${name2}`)} && ${c.accent("npx hyperframes render")}   ${c.dim("# render to MP4")}`
+          );
+          console.log(
+            `  ${c.accent("npx hyperframes docs")} ${c.dim("<topic>")}              ${c.dim("# learn composition syntax")}`
+          );
+          console.log(
+            `    ${c.dim("topics: data-attributes, gsap, compositions, rendering, templates, troubleshooting")}`
+          );
+          console.log();
+          console.log(
+            `  ${c.dim("AI skills installed \u2014 open this folder in your AI coding agent to get started.")}`
+          );
+          console.log(`  ${c.dim("Full docs: hyperframes.heygen.com")}`);
           return;
         }
         Wt2("Create a new HyperFrames project");