react-doctor 0.0.35 → 0.0.37

package/README.md

@@ -40,13 +40,15 @@ npx -y react-doctor@latest . --verbose
 
 ## Install for your coding agent
 
-Teach your coding agent all 47+ React best practice rules:
+Teach your coding agent all 47+ React best practice rules. Run this at your project root:
 
 ```bash
-curl -fsSL https://react.doctor/install-skill.sh | bash
+npx -y react-doctor@latest install
 ```
 
-Supports Cursor, Claude Code, Amp Code, Codex, Gemini CLI, OpenCode, Windsurf, and Antigravity.
+You'll be prompted to pick which detected agents to install for. Pass `--yes` to skip prompts and install for every detected agent.
+
+Supports Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, OpenCode, Factory Droid, and Pi.
 
 ## GitHub Actions
 

package/dist/cli.js

@@ -1,19 +1,281 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import fs, { existsSync, mkdirSync, mkdtempSync, readdirSync, writeFileSync } from "node:fs";
+import fs, { accessSync, constants, cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import os, { tmpdir } from "node:os";
 import path, { join } from "node:path";
 import { Command } from "commander";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+import basePrompts from "prompts";
+import ora from "ora";
 import { randomUUID } from "node:crypto";
 import { performance } from "node:perf_hooks";
 import { execSync, spawn, spawnSync } from "node:child_process";
-import pc from "picocolors";
-import basePrompts from "prompts";
 import { main } from "knip";
 import { createOptions } from "knip/session";
-import { fileURLToPath } from "node:url";
-import ora from "ora";
 
+//#region src/utils/detect-agents.ts
+const SUPPORTED_AGENTS = {
+	claude: {
+		binaries: ["claude"],
+		displayName: "Claude Code",
+		skillDir: ".claude/skills"
+	},
+	codex: {
+		binaries: ["codex"],
+		displayName: "Codex",
+		skillDir: ".codex/skills"
+	},
+	copilot: {
+		binaries: ["copilot"],
+		displayName: "GitHub Copilot",
+		skillDir: ".github/copilot/skills"
+	},
+	gemini: {
+		binaries: ["gemini"],
+		displayName: "Gemini CLI",
+		skillDir: ".gemini/skills"
+	},
+	cursor: {
+		binaries: ["cursor", "agent"],
+		displayName: "Cursor",
+		skillDir: ".cursor/skills"
+	},
+	opencode: {
+		binaries: ["opencode"],
+		displayName: "OpenCode",
+		skillDir: ".opencode/skills"
+	},
+	droid: {
+		binaries: ["droid"],
+		displayName: "Factory Droid",
+		skillDir: ".droid/skills"
+	},
+	pi: {
+		binaries: ["pi", "omegon"],
+		displayName: "Pi",
+		skillDir: ".pi/skills"
+	}
+};
+const ALL_SUPPORTED_AGENTS = Object.keys(SUPPORTED_AGENTS);
+const isCommandAvailable = (command) => {
+	const pathDirectories = (process.env.PATH ?? "").split(path.delimiter).filter(Boolean);
+	for (const directory of pathDirectories) {
+		const binaryPath = path.join(directory, command);
+		try {
+			if (statSync(binaryPath).isFile()) {
+				accessSync(binaryPath, constants.X_OK);
+				return true;
+			}
+		} catch {}
+	}
+	return false;
+};
+const detectAvailableAgents = () => ALL_SUPPORTED_AGENTS.filter((agent) => SUPPORTED_AGENTS[agent].binaries.some(isCommandAvailable));
+const toDisplayName = (agent) => SUPPORTED_AGENTS[agent].displayName;
+const toSkillDir = (agent) => SUPPORTED_AGENTS[agent].skillDir;
+
+//#endregion
+//#region src/utils/highlighter.ts
+const highlighter = {
+	error: pc.red,
+	warn: pc.yellow,
+	info: pc.cyan,
+	success: pc.green,
+	dim: pc.dim
+};
+
+//#endregion
+//#region src/utils/install-skill-for-agent.ts
+const installSkillForAgent = (projectRoot, agent, skillSourceDirectory, skillName) => {
+	const installedSkillDirectory = path.join(projectRoot, toSkillDir(agent), skillName);
+	rmSync(installedSkillDirectory, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(path.dirname(installedSkillDirectory), { recursive: true });
+	cpSync(skillSourceDirectory, installedSkillDirectory, { recursive: true });
+	return installedSkillDirectory;
+};
+
+//#endregion
+//#region src/utils/logger.ts
+const logger = {
+	error(...args) {
+		console.log(highlighter.error(args.join(" ")));
+	},
+	warn(...args) {
+		console.log(highlighter.warn(args.join(" ")));
+	},
+	info(...args) {
+		console.log(highlighter.info(args.join(" ")));
+	},
+	success(...args) {
+		console.log(highlighter.success(args.join(" ")));
+	},
+	dim(...args) {
+		console.log(highlighter.dim(args.join(" ")));
+	},
+	log(...args) {
+		console.log(args.join(" "));
+	},
+	break() {
+		console.log("");
+	}
+};
+
+//#endregion
+//#region src/utils/should-auto-select-current-choice.ts
+const shouldAutoSelectCurrentChoice = (choiceStates, cursor) => {
+	if (choiceStates.some((choiceState) => choiceState.selected)) return false;
+	const currentChoice = choiceStates[cursor];
+	return Boolean(currentChoice) && !currentChoice.disabled;
+};
+
+//#endregion
+//#region src/utils/should-select-all-choices.ts
+const shouldSelectAllChoices = (choiceStates) => {
+	return choiceStates.filter((choiceState) => !choiceState.disabled).some((choiceState) => choiceState.selected !== true);
+};
+
+//#endregion
+//#region src/utils/prompts.ts
+const require = createRequire(import.meta.url);
+const PROMPTS_MULTISELECT_MODULE_PATH = "prompts/lib/elements/multiselect";
+const PROMPTS_SELECT_MODULE_PATH = "prompts/lib/elements/select";
+let didPatchMultiselectToggleAll = false;
+let didPatchMultiselectSubmit = false;
+let didPatchSelectBanner = false;
+const selectBannerMap = /* @__PURE__ */ new Map();
+const onCancel = () => {
+	logger.break();
+	logger.log("Cancelled.");
+	logger.dim("Run `npx react-doctor@latest --fix` to fix issues.");
+	logger.break();
+	process.exit(0);
+};
+const patchMultiselectToggleAll = () => {
+	if (didPatchMultiselectToggleAll) return;
+	didPatchMultiselectToggleAll = true;
+	const multiselectPromptConstructor = require(PROMPTS_MULTISELECT_MODULE_PATH);
+	multiselectPromptConstructor.prototype.toggleAll = function() {
+		const isCurrentChoiceDisabled = Boolean(this.value[this.cursor]?.disabled);
+		if (this.maxChoices !== void 0 || isCurrentChoiceDisabled) {
+			this.bell();
+			return;
+		}
+		const shouldSelectAllEnabledChoices = shouldSelectAllChoices(this.value);
+		for (const choiceState of this.value) {
+			if (choiceState.disabled) continue;
+			choiceState.selected = shouldSelectAllEnabledChoices;
+		}
+		this.render();
+	};
+};
+const patchMultiselectSubmit = () => {
+	if (didPatchMultiselectSubmit) return;
+	didPatchMultiselectSubmit = true;
+	const multiselectPromptConstructor = require(PROMPTS_MULTISELECT_MODULE_PATH);
+	const originalSubmit = multiselectPromptConstructor.prototype.submit;
+	multiselectPromptConstructor.prototype.submit = function() {
+		if (shouldAutoSelectCurrentChoice(this.value, this.cursor)) this.value[this.cursor].selected = true;
+		originalSubmit.call(this);
+	};
+};
+const patchSelectBanner = () => {
+	if (didPatchSelectBanner) return;
+	didPatchSelectBanner = true;
+	const selectConstructor = require(PROMPTS_SELECT_MODULE_PATH);
+	const promptsClear = require("prompts/lib/util/clear");
+	const originalRender = selectConstructor.prototype.render;
+	selectConstructor.prototype.render = function() {
+		originalRender.call(this);
+		const banner = selectBannerMap.get(this.cursor);
+		if (!banner || this.closed || this.done) return;
+		this.out.write(promptsClear(this.outputText, this.out.columns));
+		this.outputText = `${banner}\n\n${this.outputText}`;
+		this.out.write(this.outputText);
+	};
+};
+const prompts = (questions) => {
+	patchMultiselectToggleAll();
+	patchMultiselectSubmit();
+	patchSelectBanner();
+	return basePrompts(questions, { onCancel });
+};
+
+//#endregion
+//#region src/utils/spinner.ts
+let sharedInstance = null;
+let activeCount = 0;
+const pendingTexts = /* @__PURE__ */ new Set();
+const finalize = (method, originalText, displayText) => {
+	pendingTexts.delete(originalText);
+	activeCount--;
+	if (activeCount <= 0 || !sharedInstance) {
+		sharedInstance?.[method](displayText);
+		sharedInstance = null;
+		activeCount = 0;
+		return;
+	}
+	sharedInstance.stop();
+	ora(displayText).start()[method](displayText);
+	const [remainingText] = pendingTexts;
+	if (remainingText) sharedInstance.text = remainingText;
+	sharedInstance.start();
+};
+const spinner = (text) => ({ start() {
+	activeCount++;
+	pendingTexts.add(text);
+	if (!sharedInstance) sharedInstance = ora({ text }).start();
+	else sharedInstance.text = text;
+	return {
+		succeed: (displayText) => finalize("succeed", text, displayText),
+		fail: (displayText) => finalize("fail", text, displayText)
+	};
+} });
+
+//#endregion
+//#region src/install-skill.ts
+const SKILL_NAME = "react-doctor";
+const getSkillSourceDirectory = () => {
+	const distDirectory = path.dirname(fileURLToPath(import.meta.url));
+	return path.join(distDirectory, "skills", SKILL_NAME);
+};
+const runInstallSkill = async (options = {}) => {
+	const projectRoot = process.cwd();
+	const sourceDir = getSkillSourceDirectory();
+	if (!existsSync(path.join(sourceDir, "SKILL.md"))) {
+		logger.error(`Could not locate the ${SKILL_NAME} skill bundled with this package.`);
+		process.exitCode = 1;
+		return;
+	}
+	const detectedAgents = detectAvailableAgents();
+	if (detectedAgents.length === 0) {
+		logger.error("No supported coding agents detected on your PATH.");
+		logger.dim("  Supported: Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, OpenCode, Factory Droid, Pi.");
+		process.exitCode = 1;
+		return;
+	}
+	const selectedAgents = Boolean(options.yes) || !process.stdin.isTTY ? detectedAgents : (await prompts({
+		type: "multiselect",
+		name: "agents",
+		message: `Install the ${highlighter.info(SKILL_NAME)} skill for:`,
+		choices: detectedAgents.map((agent) => ({
+			title: toDisplayName(agent),
+			value: agent,
+			selected: true
+		})),
+		instructions: false,
+		min: 1
+	})).agents ?? [];
+	if (selectedAgents.length === 0) return;
+	const installSpinner = spinner(`Installing ${SKILL_NAME} skill...`).start();
+	for (const agent of selectedAgents) installSkillForAgent(projectRoot, agent, sourceDir, SKILL_NAME);
+	installSpinner.succeed(`${SKILL_NAME} skill installed for ${selectedAgents.map(toDisplayName).join(", ")}.`);
+};
+
+//#endregion
 //#region src/constants.ts
 const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
@@ -140,16 +402,6 @@ const calculateScore = async (diagnostics) => {
 	}
 };
 
-//#endregion
-//#region src/utils/highlighter.ts
-const highlighter = {
-	error: pc.red,
-	warn: pc.yellow,
-	info: pc.cyan,
-	success: pc.green,
-	dim: pc.dim
-};
-
 //#endregion
 //#region src/utils/colorize-by-score.ts
 const colorizeByScore = (text, score) => {
@@ -803,32 +1055,6 @@ const discoverProject = (directory) => {
 	};
 };
 
-//#endregion
-//#region src/utils/logger.ts
-const logger = {
-	error(...args) {
-		console.log(highlighter.error(args.join(" ")));
-	},
-	warn(...args) {
-		console.log(highlighter.warn(args.join(" ")));
-	},
-	info(...args) {
-		console.log(highlighter.info(args.join(" ")));
-	},
-	success(...args) {
-		console.log(highlighter.success(args.join(" ")));
-	},
-	dim(...args) {
-		console.log(highlighter.dim(args.join(" ")));
-	},
-	log(...args) {
-		console.log(args.join(" "));
-	},
-	break() {
-		console.log("");
-	}
-};
-
 //#endregion
 //#region src/utils/framed-box.ts
 const createFramedLine = (plainText, renderedText = plainText) => ({
@@ -909,86 +1135,6 @@ const loadConfig = (rootDirectory) => {
 	return null;
 };
 
-//#endregion
-//#region src/utils/should-auto-select-current-choice.ts
-const shouldAutoSelectCurrentChoice = (choiceStates, cursor) => {
-	if (choiceStates.some((choiceState) => choiceState.selected)) return false;
-	const currentChoice = choiceStates[cursor];
-	return Boolean(currentChoice) && !currentChoice.disabled;
-};
-
-//#endregion
-//#region src/utils/should-select-all-choices.ts
-const shouldSelectAllChoices = (choiceStates) => {
-	return choiceStates.filter((choiceState) => !choiceState.disabled).some((choiceState) => choiceState.selected !== true);
-};
-
-//#endregion
-//#region src/utils/prompts.ts
-const require = createRequire(import.meta.url);
-const PROMPTS_MULTISELECT_MODULE_PATH = "prompts/lib/elements/multiselect";
-const PROMPTS_SELECT_MODULE_PATH = "prompts/lib/elements/select";
-let didPatchMultiselectToggleAll = false;
-let didPatchMultiselectSubmit = false;
-let didPatchSelectBanner = false;
-const selectBannerMap = /* @__PURE__ */ new Map();
-const onCancel = () => {
-	logger.break();
-	logger.log("Cancelled.");
-	logger.dim("Run `npx react-doctor@latest --fix` to fix issues.");
-	logger.break();
-	process.exit(0);
-};
-const patchMultiselectToggleAll = () => {
-	if (didPatchMultiselectToggleAll) return;
-	didPatchMultiselectToggleAll = true;
-	const multiselectPromptConstructor = require(PROMPTS_MULTISELECT_MODULE_PATH);
-	multiselectPromptConstructor.prototype.toggleAll = function() {
-		const isCurrentChoiceDisabled = Boolean(this.value[this.cursor]?.disabled);
-		if (this.maxChoices !== void 0 || isCurrentChoiceDisabled) {
-			this.bell();
-			return;
-		}
-		const shouldSelectAllEnabledChoices = shouldSelectAllChoices(this.value);
-		for (const choiceState of this.value) {
-			if (choiceState.disabled) continue;
-			choiceState.selected = shouldSelectAllEnabledChoices;
-		}
-		this.render();
-	};
-};
-const patchMultiselectSubmit = () => {
-	if (didPatchMultiselectSubmit) return;
-	didPatchMultiselectSubmit = true;
-	const multiselectPromptConstructor = require(PROMPTS_MULTISELECT_MODULE_PATH);
-	const originalSubmit = multiselectPromptConstructor.prototype.submit;
-	multiselectPromptConstructor.prototype.submit = function() {
-		if (shouldAutoSelectCurrentChoice(this.value, this.cursor)) this.value[this.cursor].selected = true;
-		originalSubmit.call(this);
-	};
-};
-const patchSelectBanner = () => {
-	if (didPatchSelectBanner) return;
-	didPatchSelectBanner = true;
-	const selectConstructor = require(PROMPTS_SELECT_MODULE_PATH);
-	const promptsClear = require("prompts/lib/util/clear");
-	const originalRender = selectConstructor.prototype.render;
-	selectConstructor.prototype.render = function() {
-		originalRender.call(this);
-		const banner = selectBannerMap.get(this.cursor);
-		if (!banner || this.closed || this.done) return;
-		this.out.write(promptsClear(this.outputText, this.out.columns));
-		this.outputText = `${banner}\n\n${this.outputText}`;
-		this.out.write(this.outputText);
-	};
-};
-const prompts = (questions) => {
-	patchMultiselectToggleAll();
-	patchMultiselectSubmit();
-	patchSelectBanner();
-	return basePrompts(questions, { onCancel });
-};
-
 //#endregion
 //#region src/utils/resolve-compatible-node.ts
 const parseNodeVersion = (versionString) => {
@@ -1386,6 +1532,21 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler, customRul
 		"react-doctor/query-no-query-in-effect": "warn",
 		"react-doctor/query-mutation-missing-invalidation": "warn",
 		"react-doctor/query-no-usequery-for-mutation": "warn",
+		"react-doctor/no-inline-bounce-easing": "warn",
+		"react-doctor/no-z-index-9999": "warn",
+		"react-doctor/no-inline-exhaustive-style": "warn",
+		"react-doctor/no-side-tab-border": "warn",
+		"react-doctor/no-pure-black-background": "warn",
+		"react-doctor/no-gradient-text": "warn",
+		"react-doctor/no-dark-mode-glow": "warn",
+		"react-doctor/no-justified-text": "warn",
+		"react-doctor/no-tiny-text": "warn",
+		"react-doctor/no-wide-letter-spacing": "warn",
+		"react-doctor/no-gray-on-colored-background": "warn",
+		"react-doctor/no-layout-transition-inline": "warn",
+		"react-doctor/no-disabled-zoom": "error",
+		"react-doctor/no-outline-none": "warn",
+		"react-doctor/no-long-transition-duration": "warn",
 		"react-doctor/async-parallel": "warn",
 		...framework === "nextjs" ? NEXTJS_RULES : {},
 		...framework === "expo" || framework === "react-native" ? REACT_NATIVE_RULES : {},
@@ -1507,6 +1668,21 @@ const RULE_CATEGORY_MAP = {
 	"react-doctor/query-no-query-in-effect": "TanStack Query",
 	"react-doctor/query-mutation-missing-invalidation": "TanStack Query",
 	"react-doctor/query-no-usequery-for-mutation": "TanStack Query",
+	"react-doctor/no-inline-bounce-easing": "Performance",
+	"react-doctor/no-z-index-9999": "Architecture",
+	"react-doctor/no-inline-exhaustive-style": "Architecture",
+	"react-doctor/no-side-tab-border": "Architecture",
+	"react-doctor/no-pure-black-background": "Architecture",
+	"react-doctor/no-gradient-text": "Architecture",
+	"react-doctor/no-dark-mode-glow": "Architecture",
+	"react-doctor/no-justified-text": "Accessibility",
+	"react-doctor/no-tiny-text": "Accessibility",
+	"react-doctor/no-wide-letter-spacing": "Architecture",
+	"react-doctor/no-gray-on-colored-background": "Accessibility",
+	"react-doctor/no-layout-transition-inline": "Performance",
+	"react-doctor/no-disabled-zoom": "Accessibility",
+	"react-doctor/no-outline-none": "Accessibility",
+	"react-doctor/no-long-transition-duration": "Performance",
 	"react-doctor/js-flatmap-filter": "Performance",
 	"react-doctor/async-parallel": "Performance",
 	"react-doctor/rn-no-raw-text": "React Native",
@@ -1565,6 +1741,21 @@ const RULE_HELP_MAP = {
 	"prefer-dynamic-import": "Use `const Component = dynamic(() => import('library'), { ssr: false })` from next/dynamic or React.lazy()",
 	"use-lazy-motion": "Use `import { LazyMotion, m } from \"framer-motion\"` with `domAnimation` features — saves ~30kb",
 	"no-undeferred-third-party": "Use `next/script` with `strategy=\"lazyOnload\"` or add the `defer` attribute",
+	"no-inline-bounce-easing": "Use `cubic-bezier(0.16, 1, 0.3, 1)` (ease-out-expo) for natural deceleration — objects in the real world don't bounce",
+	"no-z-index-9999": "Define a z-index scale in your design tokens (e.g. dropdown: 10, modal: 20, toast: 30). Create a new stacking context with `isolation: isolate` instead of escalating values",
+	"no-inline-exhaustive-style": "Move styles to a CSS class, CSS module, Tailwind utilities, or a styled component — inline objects with many properties hurt readability and create new references every render",
+	"no-side-tab-border": "Use a subtler accent (box-shadow inset, background gradient, or border-bottom) instead of a thick one-sided border",
+	"no-pure-black-background": "Tint the background slightly toward your brand hue — e.g. `#0a0a0f` or Tailwind's `bg-gray-950`. Pure black looks harsh on modern displays",
+	"no-gradient-text": "Use solid text colors for readability. If you need emphasis, use font weight, size, or a distinct color instead of gradients",
+	"no-dark-mode-glow": "Use a subtle `box-shadow` with neutral colors for depth, or `border` with low opacity. Colored glows on dark backgrounds are the default AI-generated aesthetic",
+	"no-justified-text": "Use `text-align: left` for body text, or add `hyphens: auto` and `overflow-wrap: break-word` if you must justify",
+	"no-tiny-text": "Use at least 12px for body content, 16px is ideal. Small text is hard to read, especially on high-DPI mobile screens",
+	"no-wide-letter-spacing": "Reserve wide tracking (letter-spacing > 0.05em) for short uppercase labels, navigation items, and buttons — not body text",
+	"no-gray-on-colored-background": "Use a darker shade of the background color for text, or white/near-white for contrast. Gray text on colored backgrounds looks washed out",
+	"no-layout-transition-inline": "Use `transform` and `opacity` for transitions — they run on the compositor thread. For height animations, use `grid-template-rows: 0fr → 1fr`",
+	"no-disabled-zoom": "Remove `user-scalable=no` and `maximum-scale` from the viewport meta tag. If your layout breaks at 200% zoom, fix the layout — don't punish users with disabilities",
+	"no-outline-none": "Use `:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px }` to show focus only for keyboard users while hiding it for mouse clicks",
+	"no-long-transition-duration": "Keep UI transitions under 1s — 100-150ms for instant feedback, 200-300ms for state changes, 300-500ms for layout changes. Use longer durations only for page-load hero animations",
 	"no-array-index-as-key": "Use a stable unique identifier: `key={item.id}` or `key={item.slug}` — index keys break on reorder/filter",
 	"rendering-conditional-render": "Change to `{items.length > 0 && <List />}` or use a ternary: `{items.length ? <List /> : null}`",
 	"no-prevent-default": "Use `<form action={serverAction}>` (works without JS) or `<button>` instead of `<a>` with preventDefault",
@@ -1762,37 +1953,6 @@ const runOxlint = async (rootDirectory, hasTypeScript, framework, hasReactCompil
 	}
 };
 
-//#endregion
-//#region src/utils/spinner.ts
-let sharedInstance = null;
-let activeCount = 0;
-const pendingTexts = /* @__PURE__ */ new Set();
-const finalize = (method, originalText, displayText) => {
-	pendingTexts.delete(originalText);
-	activeCount--;
-	if (activeCount <= 0 || !sharedInstance) {
-		sharedInstance?.[method](displayText);
-		sharedInstance = null;
-		activeCount = 0;
-		return;
-	}
-	sharedInstance.stop();
-	ora(displayText).start()[method](displayText);
-	const [remainingText] = pendingTexts;
-	if (remainingText) sharedInstance.text = remainingText;
-	sharedInstance.start();
-};
-const spinner = (text) => ({ start() {
-	activeCount++;
-	pendingTexts.add(text);
-	if (!sharedInstance) sharedInstance = ora({ text }).start();
-	else sharedInstance.text = text;
-	return {
-		succeed: (displayText) => finalize("succeed", text, displayText),
-		fail: (displayText) => finalize("fail", text, displayText)
-	};
-} });
-
 //#endregion
 //#region src/scan.ts
 const SEVERITY_ORDER = {
@@ -2352,7 +2512,7 @@ const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.35";
+const VERSION = "0.0.37";
 const VALID_FAIL_ON_LEVELS = new Set([
 	"error",
 	"warning",
@@ -2510,6 +2670,13 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 ${highlighter.dim("Learn more:")}
   ${highlighter.info("https://github.com/millionco/react-doctor")}
 `);
+program.command("install").description("Install the react-doctor skill into your coding agents").option("-y, --yes", "skip prompts, install for all detected agents").action(async (options) => {
+	try {
+		await runInstallSkill({ yes: options.yes });
+	} catch (error) {
+		handleError(error);
+	}
+});
 const main$1 = async () => {
 	await program.parseAsync();
 };