feat: integrate skill installation prompt into CLI workflow

Author: aidenybai

packages/react-doctor/src/cli.ts

@@ -15,6 +15,7 @@ import { loadConfig } from "./utils/load-config.js";
 import { logger } from "./utils/logger.js";
 import { clearSelectBanner, prompts, setSelectBanner } from "./utils/prompts.js";
 import { selectProjects } from "./utils/select-projects.js";
+import { maybePromptSkillInstall } from "./utils/skill-prompt.js";
 
 const VERSION = process.env.VERSION ?? "0.0.0";
 
@@ -190,6 +191,7 @@ const program = new Command()
       }
 
       if (!isScoreOnly && !shouldSkipAmiPrompts && !flags.fix) {
+        await maybePromptSkillInstall(shouldSkipAmiPrompts);
         const estimatedScoreResult = flags.offline
           ? null
           : await fetchEstimatedScore(allDiagnostics);

packages/react-doctor/src/constants.ts

@@ -26,6 +26,8 @@ export const SHARE_BASE_URL = "https://www.react.doctor/share";
 
 export const OPEN_BASE_URL = "https://www.react.doctor/open";
 
+export const INSTALL_SKILL_URL = "https://www.react.doctor/install-skill";
+
 export const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
 
 export const OFFLINE_MESSAGE =

packages/react-doctor/src/utils/skill-prompt.ts

@@ -0,0 +1,73 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { INSTALL_SKILL_URL } from "../constants.js";
+import { highlighter } from "./highlighter.js";
+import { logger } from "./logger.js";
+import { prompts } from "./prompts.js";
+
+const CONFIG_DIRECTORY = join(homedir(), ".react-doctor");
+const CONFIG_FILE = join(CONFIG_DIRECTORY, "config.json");
+
+interface SkillPromptConfig {
+  skillPromptDismissed?: boolean;
+}
+
+const readSkillPromptConfig = (): SkillPromptConfig => {
+  try {
+    if (!existsSync(CONFIG_FILE)) return {};
+    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+  } catch {
+    return {};
+  }
+};
+
+const writeSkillPromptConfig = (config: SkillPromptConfig): void => {
+  try {
+    if (!existsSync(CONFIG_DIRECTORY)) {
+      mkdirSync(CONFIG_DIRECTORY, { recursive: true });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+  } catch {}
+};
+
+const installSkill = (): void => {
+  try {
+    execSync(`curl -fsSL ${INSTALL_SKILL_URL} | bash`, { stdio: "inherit" });
+  } catch {
+    logger.break();
+    logger.dim("Skill install failed. You can install manually:");
+    logger.dim(`  curl -fsSL ${INSTALL_SKILL_URL} | bash`);
+  }
+};
+
+export const maybePromptSkillInstall = async (shouldSkipPrompts: boolean): Promise<void> => {
+  const config = readSkillPromptConfig();
+  if (config.skillPromptDismissed) return;
+  if (shouldSkipPrompts) return;
+
+  logger.break();
+  logger.log(
+    `${highlighter.info("💡")} Have your coding agent fix these issues automatically?`,
+  );
+  logger.dim(
+    `   Install the ${highlighter.info("react-doctor")} skill to teach Cursor, Claude Code,`,
+  );
+  logger.dim("   Ami, and other AI agents how to diagnose and fix React issues.");
+  logger.break();
+
+  const { shouldInstall } = await prompts({
+    type: "confirm",
+    name: "shouldInstall",
+    message: "Install skill? (recommended)",
+    initial: true,
+  });
+
+  if (shouldInstall) {
+    logger.break();
+    installSkill();
+  }
+
+  writeSkillPromptConfig({ ...config, skillPromptDismissed: true });
+};