Function ensureSkillsCurrent

packages/cli/src/commands/init.ts:589–623

* Ensure the AI coding skills are present and current. Checks the installed * skills against the latest published on GitHub and only (re)installs when * something is outdated or missing — so re-running `init` on an up-to-date * machine is a no-op. Best-effort: if the version check can't reach Git

(destDir: string)

 * to match.
 */
async function ensureSkillsCurrent(destDir: string): Promise<void> {
  const { installAllSkills } = await import("./skills.js");
  const { checkSkills } = await import("../utils/skillsManifest.js");

  console.log();
  console.log(c.bold("Checking AI coding skills against GitHub..."));
  let needsInstall = true;
  try {
    const result = await checkSkills({ cwd: destDir });
    needsInstall = result.updateAvailable;
  } catch {
    // Couldn't reach GitHub (offline, rate-limited) — install anyway.
  }

  if (needsInstall) {
    // installAllSkills installs the full set once globally and mirrors it into
    // every installed agent's global dir — project-independent, so a freshly
    // scaffolded project doesn't need any agent folders yet.
    //
    // Best-effort: installAllSkills (non-strict here) already swallows its own
    // failures, but now that --skip-skills no longer escapes this path every
    // init runs it — including offline ones, where checkSkills throws and we
    // fall through to "install anyway". Wrap defensively so a skills-install
    // failure can never break `init` itself; it only warns and proceeds.
    try {
      await installAllSkills({ cwd: destDir });
    } catch (err) {
      console.log(
        c.dim(`AI coding skills install skipped: ${err instanceof Error ? err.message : err}`),
      );
    }
  } else {
    console.log(c.success("AI coding skills are already up to date."));
  }
}

// ---------------------------------------------------------------------------
// Exported command