fix(cli): install skills into project dir on non-interactive init (#1671)

`hyperframes init` only installed AI coding skills on the interactive path
(behind a clack confirm). When an agent drives it non-interactively (no TTY),
it just printed `npx skills add ...` and returned — so skills were never
installed and the agent later hit `Unknown skill: <workflow>`.

- init: both interactive and non-interactive branches now run
  `npx skills add` with `cwd` set to the new project dir so skills land
  there, not in the caller's working directory. Non-interactive additionally
  passes `--yes`; when Claude Code is driving (CLAUDECODE env var), adds
  `--agent claude-code` so skills target `.claude/skills/`.
- skills: `runSkillsAdd` accepts `cwd` and `extraArgs` so callers can
  control where and how skills are installed.
- templates: CLAUDE.md / AGENTS.md now tell agents to run
  `npx skills add heygen-com/hyperframes` to install or update skills.

Co-authored-by: Wenbo Zhu <295860553+kiritowoo@users.noreply.github.com>

Author: miguel-heygen

packages/cli/src/commands/init.ts

@@ -800,11 +800,27 @@ export default defineCommand({
       for (const f of readdirSync(destDir).filter((f) => !f.startsWith("."))) {
         console.log(`  ${c.accent(f)}`);
       }
+
+      if (!skipSkills) {
+        const { installAllSkills } = await import("./skills.js");
+        // --yes keeps it non-interactive. When Claude Code is driving
+        // (CLAUDECODE env var), target its native dir so skills land in
+        // .claude/skills/ instead of only .agents/skills/.
+        const args = process.env["CLAUDECODE"] ? ["--agent", "claude-code", "--yes"] : ["--yes"];
+        await installAllSkills({ cwd: destDir, extraArgs: args });
+      }
+
       console.log();
       console.log("Get started:");
       console.log();
-      console.log(`  ${c.accent("1.")} Install AI coding skills (one-time):`);
-      console.log(`     ${c.accent("npx skills add heygen-com/hyperframes")}`);
+      if (skipSkills) {
+        console.log(`  ${c.accent("1.")} Install AI coding skills (one-time):`);
+        console.log(`     ${c.accent("npx skills add heygen-com/hyperframes --yes")}`);
+      } else {
+        console.log(
+          `  ${c.accent("1.")} Restart your AI agent (new session) so it loads the skills.`,
+        );
+      }
       console.log();
       console.log(`  ${c.accent("2.")} Open this project with your AI coding agent:`);
       console.log(
@@ -1018,8 +1034,8 @@ export default defineCommand({
         process.exit(0);
       }
       if (installSkills) {
-        const skillsCmd = await import("./skills.js").then((m) => m.default);
-        await runCommand(skillsCmd, { rawArgs: [] });
+        const { installAllSkills } = await import("./skills.js");
+        await installAllSkills({ cwd: destDir });
       }
     }
 

packages/cli/src/commands/skills.ts

@@ -14,12 +14,16 @@ function hasNpx(): boolean {
   }
 }
 
-function runSkillsAdd(repo: string): Promise<void> {
-  const npx = buildNpxCommand(["skills", "add", repo, "--all"]);
+function runSkillsAdd(
+  repo: string,
+  opts: { cwd?: string; extraArgs?: string[] } = {},
+): Promise<void> {
+  const npx = buildNpxCommand(["skills", "add", repo, ...(opts.extraArgs ?? ["--all"])]);
   return new Promise((resolve, reject) => {
     const child = spawn(npx.command, npx.args, {
       stdio: "inherit",
       timeout: 120_000,
+      cwd: opts.cwd,
       // GH #316 — the upstream `skills` CLI shells out to `git clone`.
       // When Git's clone-hook protection is active (shipped on by
       // default in 2.45.1, reverted in 2.45.2, still present on many
@@ -40,27 +44,33 @@ function runSkillsAdd(repo: string): Promise<void> {
 
 const SOURCES = [{ name: "HyperFrames", repo: "heygen-com/hyperframes" }];
 
+export async function installAllSkills(
+  opts: { cwd?: string; extraArgs?: string[] } = {},
+): Promise<void> {
+  if (!hasNpx()) {
+    clack.log.error(c.error("npx not found. Install Node.js and retry."));
+    return;
+  }
+
+  for (const source of SOURCES) {
+    console.log();
+    console.log(c.bold(`Installing ${source.name} skills...`));
+    console.log();
+    try {
+      await runSkillsAdd(source.repo, opts);
+    } catch {
+      console.log(c.dim(`${source.name} skills skipped`));
+    }
+  }
+}
+
 export default defineCommand({
   meta: {
     name: "skills",
     description: "Install HyperFrames skills for AI coding tools",
   },
   args: {},
   async run() {
-    if (!hasNpx()) {
-      clack.log.error(c.error("npx not found. Install Node.js and retry."));
-      return;
-    }
-
-    for (const source of SOURCES) {
-      console.log();
-      console.log(c.bold(`Installing ${source.name} skills...`));
-      console.log();
-      try {
-        await runSkillsAdd(source.repo);
-      } catch {
-        console.log(c.dim(`${source.name} skills skipped`));
-      }
-    }
+    await installAllSkills();
   },
 });

packages/cli/src/templates/_shared/AGENTS.md

@@ -21,8 +21,8 @@ The domain skills (`/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-
 
 > **Tailwind v4 projects** (`hyperframes init --tailwind`): see `/hyperframes-core` → `references/tailwind.md`.
 
-> **Skills not available?** Ask the user to run `npx hyperframes skills` and restart their
-> agent session, or install manually: `npx skills add heygen-com/hyperframes`.
+> **Skills not available or need updating?** Run `npx skills add heygen-com/hyperframes`
+> and restart the agent session so the new skills load.
 
 ## Commands
 

packages/cli/src/templates/_shared/CLAUDE.md

@@ -21,8 +21,8 @@ The domain skills (`/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-
 
 > **Tailwind v4 projects** (`hyperframes init --tailwind`): see `/hyperframes-core` → `references/tailwind.md`.
 
-> **Skills not available?** Ask the user to run `npx hyperframes skills` and restart their
-> agent session, or install manually: `npx skills add heygen-com/hyperframes`.
+> **Skills not available or need updating?** Run `npx skills add heygen-com/hyperframes`
+> and restart the agent session so the new skills load.
 
 ## Commands