feat: install skills command

bin.ts

@@ -6,7 +6,7 @@
 import { hideBin } from 'yargs/helpers';
 import { VERSION } from './src/lib/version.js';
 
 const WIZARD_VERSION = VERSION;
 
 const NODE_VERSION_RANGE = '>=18.17.0';
 
@@ -267,7 +267,7 @@
           const { startPlayground } = await import(
             './src/ui/tui/playground/start-playground.js'
           );
           (startPlayground as (version: string) => void)(WIZARD_VERSION);
         })();
       } else if (options.skill) {
         // Run a specific skill by ID
@@ -302,6 +302,50 @@
       }
     },
   )
+  .command('skills <command>', 'Skills management commands', (yargs) => {
+    return yargs
+      .command(
+        'install',
+        'Fetch PostHog skills from GitHub Releases and install selected skills into .claude/skills/',
+        (yargs) => {
+          return yargs.options({
+            'install-dir': {
+              describe:
+                'Directory to install skills in (defaults to current directory).\nSkills are written to {dir}/.claude/skills/ and are scoped to that project.\nTo install globally across all projects, pass your home directory: --install-dir ~\nenv: POSTHOG_WIZARD_INSTALL_DIR',
+              type: 'string',
+            },
+          });
+        },
+        (argv) => {
+          const options = { ...argv };
+          void (async () => {
+            try {
+              const { startTUI } = await import('./src/ui/tui/start-tui.js');
+              const { buildSession } = await import(
+                './src/lib/wizard-session.js'
+              );
+              const { Flow } = await import('./src/ui/tui/router.js');
+
+              const tui = startTUI(WIZARD_VERSION, Flow.SkillsInstall);
+              const session = buildSession({
+                debug: options.debug as boolean | undefined,
+                installDir: options.installDir as string | undefined,
+              });
+              tui.store.session = session;
+            } catch {
+              setUI(new LoggingUI());
+              getUI().log.error(
+                'Skills install requires an interactive terminal (TTY).\n' +
+                  'Please run this command in an interactive terminal.',
+              );
+              process.exit(1);
+            }
+          })();
+        },
+      )
+      .demandCommand(1, 'You must specify a subcommand (install)')
+      .help();
+  })
   .command('mcp <command>', 'MCP server management commands', (yargs) => {
     return yargs
       .command(
@@ -347,7 +391,7 @@
               );
 
               const { Flow } = await import('./src/ui/tui/router.js');
               const tui = startTUI(WIZARD_VERSION, Flow.McpAdd);
               const session = buildSession({
                 debug: options.debug,
                 localMcp: options.local,
@@ -393,7 +437,7 @@
               );
 
               const { Flow } = await import('./src/ui/tui/router.js');
               const tui = startTUI(WIZARD_VERSION, Flow.McpRemove);
               const session = buildSession({
                 debug: options.debug,
                 localMcp: options.local,
@@ -419,7 +463,7 @@
 // ── Skill-based workflow subcommands (derived from registry) ─────────
 for (const wfConfig of getSubcommandWorkflows()) {
   cli.command(
     wfConfig.command!,
     wfConfig.description,
     (y) => y.options(skillSubcommandOptions),
     (argv) => {
@@ -457,7 +501,7 @@
       const { buildSession } = await import('./src/lib/wizard-session.js');
 
       // flowKey values match Flow enum values by convention
       const tui = startTUI(WIZARD_VERSION, config.flowKey as any);
 
       const session = buildSession({
         debug: options.debug as boolean | undefined,
@@ -469,7 +513,7 @@
         apiKey: options.apiKey as string | undefined,
         projectId: options.projectId as string | undefined,
         menu: options.menu as boolean | undefined,
         integration: options.integration as any,
         benchmark: options.benchmark as boolean | undefined,
         yaraReport: options.yaraReport as boolean | undefined,
       });