diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 309968f40f9..8d416b5c01e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1423,8 +1423,7 @@ jobs:
           test -s /tmp/hf-cli-input.mp4
 
       - name: Smoke-test CLI from monorepo source
-        # init's --skip-skills flag is neutered (see init.ts); opt out of the
-        # GitHub skills check via this env so the smoke test stays offline/fast.
+        # Skip skill installation and GitHub checks to keep the smoke test offline.
         env:
           HYPERFRAMES_SKIP_SKILLS: "1"
         run: |
@@ -1487,8 +1486,7 @@ jobs:
           npm install -g --prefix /tmp/hf-cli-global "$HF_CLI_TARBALL"
 
       - name: Smoke-test packed CLI outside monorepo
-        # init's --skip-skills flag is neutered (see init.ts); opt out of the
-        # GitHub skills check via this env so the smoke test stays offline/fast.
+        # Skip skill installation and GitHub checks to keep the smoke test offline.
         env:
           HYPERFRAMES_SKIP_SKILLS: "1"
         run: |
diff --git a/.github/workflows/windows-render.yml b/.github/workflows/windows-render.yml
index 4bd7e764864..8259f2b5d69 100644
--- a/.github/workflows/windows-render.yml
+++ b/.github/workflows/windows-render.yml
@@ -247,8 +247,7 @@ jobs:
 
       - name: Scaffold canary composition
         shell: pwsh
-        # init's --skip-skills flag is neutered (see init.ts); opt out of the
-        # GitHub skills check via this env so the canary scaffold stays offline.
+        # Skip skill installation and GitHub checks to keep the canary scaffold offline.
         env:
           HYPERFRAMES_SKIP_SKILLS: "1"
         run: |
diff --git a/packages/cli/src/commands/init.ts b/packages/cli/src/commands/init.ts
index 2412b58967c..6166739d858 100644
--- a/packages/cli/src/commands/init.ts
+++ b/packages/cli/src/commands/init.ts
@@ -18,10 +18,7 @@ export const examples: Example[] = [
   ["Start from an audio file", "hyperframes init my-video --audio track.mp3"],
   ["Scaffold with Tailwind CSS", "hyperframes init my-video --tailwind"],
   ["Non-interactive mode (for CI or AI agents)", "hyperframes init my-video --non-interactive"],
-  [
-    "Opt out of the GitHub skills check (CI/tests only)",
-    "HYPERFRAMES_SKIP_SKILLS=1 hyperframes init my-video --non-interactive",
-  ],
+  ["Skip installing AI skills", "hyperframes init my-video --skip-skills"],
 ];
 import {
   existsSync,
@@ -774,8 +771,7 @@ export default defineCommand({
     },
     "skip-skills": {
       type: "boolean",
-      description:
-        "[temporarily ignored] init always checks AI skills against GitHub while the skills.sh registry catches up; set HYPERFRAMES_SKIP_SKILLS=1 to opt out (CI/tests)",
+      description: "Skip installing missing core AI skills (also HYPERFRAMES_SKIP_SKILLS=1)",
     },
     tailwind: {
       type: "boolean",