argsbarg 6.3.2 → 7.0.0

package/src/configure/index.ts

@@ -1,193 +1,28 @@
 /*
-Interactive and automated `configure` command orchestration (agent artifacts and app config).
+`configure install` / `configure uninstall` / `configure status` orchestration.
 */
 
-import { displayAppConfigPath, runConfigure } from "../config/bootstrap.ts";
+import { bootstrapAppConfig, displayAppConfigPath, runConfigure } from "../config/bootstrap.ts";
 import { ensureAppConfigFile } from "../config/file.ts";
+import { formatMissingConfigMessage, missingRequiredConfig } from "../config/resolve.ts";
 import type { CliProgram, ConfigureHookContext } from "../core/types.ts";
-import { resolveCapabilities } from "../runtime/capabilities.ts";
-import { cliSkillInstall, isAgentSkillActionKind } from "../skill/install.ts";
-import { displayInstallPath, type InstallPaths, resolveInstallPaths } from "./artifacts/paths.ts";
-import { buildInstallPlan, buildUpdatePlan } from "./artifacts/plan.ts";
-import {
-  installErr,
-  installInfo,
-  installOut,
-  printInstallStatus,
-  writeInteractiveInstallIntro,
-} from "./artifacts/status.ts";
-import { resolveEffectiveInstallTargets } from "./artifacts/target-effective.ts";
-import { runTargetPreflight } from "./artifacts/target-plan-build.ts";
-import { INSTALL_TARGETS, installTargetForKey } from "./artifacts/target-registry.ts";
-import { buildDetectedSnapshot, buildTargetPlanContext } from "./artifacts/target-scope.ts";
-import type {
-  CliInstallArtifactKey,
-  InstallAction,
-  InstallOpts,
-  TargetPlanContext,
-  UninstallAction,
-} from "./artifacts/target-types.ts";
-import { buildUninstallPlan, skillDirFromUninstallSummary, uninstallSkillDir } from "./artifacts/uninstall.ts";
-import { artifactPromptLabel, promptTargetAction } from "./prompt.ts";
-
-/** True when interactive `configure` should auto-run the app config wizard. */
+import { readPromptLine } from "../prompt.ts";
+import { type InstallPaths, resolveInstallPaths } from "./artifacts/paths.ts";
+import { buildUpdatePlan } from "./artifacts/plan.ts";
+import { installErr, printInstallStatus } from "./artifacts/status.ts";
+import type { InstallAction, InstallOpts, UninstallAction } from "./artifacts/target-types.ts";
+import { buildUninstallPlan } from "./artifacts/uninstall.ts";
+
+/** True when `program.appConfig` has wizard entries. */
 export function appConfigHasEntries(program: CliProgram): boolean {
   const entries = program.appConfig?.entries;
   return !!entries && Object.keys(entries).length > 0;
 }
 
-/** Parsed flags for the top-level `configure` built-in. */
-export interface ConfigureOpts {
-  refresh?: boolean;
-  removeAll?: boolean;
-  removeConfig?: boolean;
-  status?: boolean;
-  yes?: boolean;
-  dry?: boolean;
-  json?: boolean;
-}
-
-/** Maps raw argv flags into {@link ConfigureOpts}. */
-export function parseConfigureOpts(raw: Record<string, string>): ConfigureOpts {
-  const flag = (name: string) => raw[name] === "1";
-  return {
-    refresh: flag("refresh"),
-    removeAll: flag("remove-all"),
-    removeConfig: flag("remove-config"),
-    status: flag("status"),
-    yes: flag("yes"),
-    dry: flag("dry"),
-    json: flag("json"),
-  };
-}
-
-/** Returns an error message when configure flags are inconsistent; otherwise null. */
-export function validateConfigureOpts(opts: ConfigureOpts): string | null {
-  const flags = [opts.refresh, opts.removeAll, opts.removeConfig, opts.status].filter(Boolean);
-  if (flags.length > 1) {
-    return "Use only one of --refresh, --remove-all, --remove-config, or --status.";
-  }
-  if (opts.json) {
-    opts.yes = true;
-  }
-  if ((opts.refresh || opts.removeAll || opts.removeConfig) && !opts.yes) {
-    return "--yes is required with --refresh, --remove-all, or --remove-config.";
-  }
-  return null;
-}
-
-/** Adapts configure flags to internal install-plan option shape. */
-function configureToInstallOpts(opts: ConfigureOpts): InstallOpts {
-  if (opts.status) {
-    return { status: true, yes: opts.yes, dry: opts.dry, json: opts.json };
-  }
-  if (opts.refresh) {
-    return { reinstall: true, yes: true, dry: opts.dry, json: opts.json };
-  }
-  if (opts.removeAll) {
-    return { uninstall: true, all: true, yes: true, dry: opts.dry, json: opts.json };
-  }
-  if (opts.removeConfig) {
-    return { uninstall: true, configure: true, yes: true, dry: opts.dry, json: opts.json };
-  }
-  return { dry: opts.dry, json: opts.json };
-}
-
-/** Installs the agent skill bundle and returns changed paths. */
-function runSkillAction(root: CliProgram, opts: InstallOpts): string[] {
-  return cliSkillInstall(root, {
-    global: true,
-    rimraf: true,
-    dry: opts.dry,
-  });
-}
-
-/** Tallies configure mutations for the closing summary and `--json` output. */
-export interface ConfigureMutationSummary {
-  paths: string[];
-  installed: number;
-  removed: number;
-  configured: number;
-}
-
-function emptyMutationSummary(): ConfigureMutationSummary {
-  return { paths: [], installed: 0, removed: 0, configured: 0 };
-}
-
-function mergeMutationSummary(into: ConfigureMutationSummary, from: ConfigureMutationSummary): void {
-  into.paths.push(...from.paths);
-  into.installed += from.installed;
-  into.removed += from.removed;
-  into.configured += from.configured;
-}
-
-function recordArtifactMutation(
-  summary: ConfigureMutationSummary,
-  paths: string[],
-  kind: "installed" | "removed" | "configured",
-): void {
-  if (paths.length === 0) return;
-  summary.paths.push(...paths);
-  summary[kind]++;
-}
-
-/** Human-readable closing line for configure mutations. */
-export function formatConfigureMutationSummary(summary: ConfigureMutationSummary, opts: ConfigureOpts): string | null {
-  if (summary.paths.length === 0) return null;
-
-  if (opts.removeAll || opts.removeConfig) {
-    const n = summary.removed;
-    if (n === 0) return null;
-    return n === 1 ? "Removed 1 artifact." : `Removed ${n} artifacts.`;
-  }
-
-  if (opts.refresh) {
-    const n = summary.installed;
-    if (n === 0) return null;
-    return n === 1 ? "Refreshed 1 artifact." : `Refreshed ${n} artifacts.`;
-  }
-
-  const parts: string[] = [];
-  if (summary.removed > 0) {
-    parts.push(summary.removed === 1 ? "Removed 1 artifact" : `Removed ${summary.removed} artifacts`);
-  }
-  if (summary.installed > 0) {
-    parts.push(summary.installed === 1 ? "Installed 1 artifact" : `Installed ${summary.installed} artifacts`);
-  }
-  if (summary.configured > 0) {
-    parts.push("Updated app config");
-  }
-  if (parts.length === 0) return null;
-  return `${parts.join("; ")}.`;
-}
-
-/** Runs one install/uninstall action and returns changed paths. */
-function runPlanAction(
-  root: CliProgram,
-  action: InstallAction | UninstallAction,
-  opts: InstallOpts,
-  paths: ReturnType<typeof resolveInstallPaths>,
-): string[] {
-  if ("kind" in action && action.kind && isAgentSkillActionKind(action.kind)) {
-    const runResult = action.run();
-    if (runResult.length > 0) return runResult;
-    if (opts.uninstall) {
-      const skillDir = skillDirFromUninstallSummary(action.summary, paths);
-      return skillDir ? uninstallSkillDir(skillDir, !!opts.dry) : [];
-    }
-    return runSkillAction(root, opts);
-  }
-  if (!("kind" in action) || !action.kind) {
-    const skillDir = skillDirFromUninstallSummary(action.summary, paths);
-    if (skillDir) return uninstallSkillDir(skillDir, !!opts.dry);
-  }
-  return action.run();
-}
-
-function configureHookContext(root: CliProgram, paths: InstallPaths, dry: boolean): ConfigureHookContext {
+function configureHookContext(root: CliProgram, paths: InstallPaths): ConfigureHookContext {
   return {
     program: root,
-    dry,
+    dry: false,
     paths: {
       agentsSkillDir: paths.agentsSkillDir,
       agentsMcpPath: paths.agentsMcpPath,
@@ -201,213 +36,88 @@ async function runConfigureLifecycleHook(
   hook: ((ctx: ConfigureHookContext) => void | Promise<void>) | undefined,
   root: CliProgram,
   paths: InstallPaths,
-  dry: boolean,
 ): Promise<void> {
   if (!hook) return;
-  await hook(configureHookContext(root, paths, dry));
+  await hook(configureHookContext(root, paths));
 }
 
-/** Runs install or uninstall actions and collects changed paths. */
-function executePlan(
-  root: CliProgram,
-  actions: Array<InstallAction | UninstallAction>,
-  opts: InstallOpts,
-  showProgress: boolean,
-): ConfigureMutationSummary {
-  const summary = emptyMutationSummary();
-  const paths = resolveInstallPaths(root);
+function executePlan(actions: Array<InstallAction | UninstallAction>): void {
   for (const action of actions) {
-    if (showProgress) {
-      installInfo(action.message, opts);
-    }
-    const changed = runPlanAction(root, action, opts, paths);
-    if (changed.length === 0) continue;
-    if (action.kind === "agent-skill" && !opts.uninstall && !opts.dry) {
-      installOut(`Skill installed to ${displayInstallPath(paths.agentsSkillDir)}/`, opts);
-    }
-    if (action.kind === "agents-mcp" && !opts.uninstall && !opts.dry) {
-      installOut(`MCP server registered in ${displayInstallPath(paths.agentsMcpPath)}`, opts);
-    }
-    if (action.kind === "configure") {
-      recordArtifactMutation(summary, changed, opts.uninstall ? "removed" : "configured");
-    } else {
-      recordArtifactMutation(summary, changed, opts.uninstall ? "removed" : "installed");
-    }
+    action.run();
   }
-  return summary;
 }
 
-/** Builds plan context limited to a single artifact key. */
-function buildSingleTargetContext(
-  root: CliProgram,
-  paths: ReturnType<typeof resolveInstallPaths>,
-  detected: ReturnType<typeof buildDetectedSnapshot>,
-  key: CliInstallArtifactKey,
-  mode: "install" | "uninstall",
-  opts: InstallOpts,
-): TargetPlanContext {
-  const effective = resolveEffectiveInstallTargets(root.configure, root);
-  const base = buildTargetPlanContext(root, paths, opts, detected);
-  return {
-    ...base,
-    mode: mode === "install" ? "install-scoped" : "uninstall-scoped",
-    include: (k) => k === key && effective[k].enabled,
-  };
-}
+function runInstallWizard(root: CliProgram): void {
+  if (!appConfigHasEntries(root)) return;
 
-/** Resolves install or uninstall actions for one artifact target. */
-function actionsForTarget(
-  root: CliProgram,
-  paths: ReturnType<typeof resolveInstallPaths>,
-  key: CliInstallArtifactKey,
-  action: "install" | "uninstall",
-  opts: InstallOpts,
-): Array<InstallAction | UninstallAction> {
-  const detected = buildDetectedSnapshot(root, paths);
-  const target = installTargetForKey(key);
-  if (!target) return [];
-  const ctx = buildSingleTargetContext(root, paths, detected, key, action, opts);
-  if (action === "install") {
-    return target.planInstall(ctx);
-  }
-  return target.planUninstall(ctx);
-}
+  const { resolved } = bootstrapAppConfig(root, { validateFile: false });
+  const missing = missingRequiredConfig(root, resolved);
 
-/** Walks enabled targets with per-target prompts (TTY required). */
-async function runInteractiveConfigure(root: CliProgram, opts: ConfigureOpts): Promise<ConfigureMutationSummary> {
-  if (!process.stdin.isTTY) {
-    throw new Error("Interactive configure requires a TTY. Use flags such as --refresh --yes.");
+  if (process.stdin.isTTY) {
+    if (missing.length === 0) return;
+    runConfigure(root, { context: "after-install", showHeading: true, rePromptAll: false });
+    return;
   }
 
-  writeInteractiveInstallIntro(root);
-  const paths = resolveInstallPaths(root);
-  const detected = buildDetectedSnapshot(root, paths);
-  const effective = resolveEffectiveInstallTargets(root.configure, root);
-  const mutationOpts: InstallOpts = { dry: opts.dry, json: opts.json };
-  const summary = emptyMutationSummary();
-
-  for (const target of INSTALL_TARGETS) {
-    if (target.key === "app" || target.key === "skill" || target.key === "agentsMcp") continue;
-    if (!effective[target.key].enabled) continue;
-    if (target.key !== "configure" && !target.isAvailable(root, paths)) continue;
-    if (target.key === "configure" && !root.appConfig) continue;
-
-    if (target.key === "configure") {
-      if (!appConfigHasEntries(root)) continue;
-
-      const result = runConfigure(root, { context: "standalone", showHeading: false, rePromptAll: true });
-      if (result.changed) {
-        installOut(`Wrote config: ${displayAppConfigPath(root)}`, mutationOpts);
-        recordArtifactMutation(summary, [displayAppConfigPath(root)], "configured");
-      }
-      continue;
-    }
-
-    const label = artifactPromptLabel(target.key);
-    const installed = target.detectedForSnapshot(detected);
-
-    const statusHint = installed ? "installed" : "not installed";
-    process.stderr.write(`\n${label} (${statusHint})\n`);
-    const choice = promptTargetAction(label, installed);
-    if (!choice || choice === "skip") continue;
-
-    const actions = actionsForTarget(root, paths, target.key, choice, mutationOpts);
-    if (actions.length === 0) continue;
-
-    const installActions = actions.filter(
-      (a): a is InstallAction => "kind" in a && typeof a.kind === "string" && a.kind.includes("-mcp"),
-    );
-    if (choice === "install" && resolveCapabilities(root).mcp && installActions.length > 0) {
-      runTargetPreflight(root, paths, mutationOpts, installActions);
-    }
-
-    mergeMutationSummary(
-      summary,
-      executePlan(root, actions, { ...mutationOpts, uninstall: choice === "uninstall" }, true),
-    );
+  if (missing.length > 0) {
+    installErr(formatMissingConfigMessage(root, missing));
+    process.exit(1);
   }
-
-  return summary;
 }
 
-/** Runs sync, remove, or status modes without per-target prompts. */
-async function runAutomatedConfigure(root: CliProgram, opts: ConfigureOpts): Promise<ConfigureMutationSummary> {
-  const installOpts = configureToInstallOpts(opts);
-  const paths = resolveInstallPaths(root);
-
-  if (installOpts.status) {
-    printInstallStatus(root, installOpts);
-    return emptyMutationSummary();
+function confirmUninstall(root: CliProgram, yes: boolean): void {
+  if (yes || !process.stdin.isTTY) return;
+  process.stderr.write(`Remove agent artifacts for ${root.key}? [y/N]: `);
+  const ans = readPromptLine().trim().toLowerCase();
+  if (ans !== "y" && ans !== "yes") {
+    process.exit(0);
   }
+}
 
-  const summary = emptyMutationSummary();
-
-  if (opts.removeAll) {
-    await runConfigureLifecycleHook(root.configure?.beforeRemoveAll, root, paths, !!installOpts.dry);
-  }
+/** Installs agent artifacts, bootstraps config, and runs the required-config wizard when needed. */
+export async function cliConfigureInstall(root: CliProgram): Promise<never> {
+  const paths = resolveInstallPaths(root);
+  const installOpts: InstallOpts = { reinstall: true, all: true };
 
-  if (installOpts.reinstall && !installOpts.uninstall) {
-    const bootstrapped = ensureAppConfigFile(root, !!installOpts.dry);
+  try {
+    const bootstrapped = ensureAppConfigFile(root, false);
     if (bootstrapped) {
-      const display = displayAppConfigPath(root);
-      recordArtifactMutation(summary, [display], "configured");
-      installOut(`Initialized config: ${display}`, installOpts);
+      process.stdout.write(`Initialized config: ${displayAppConfigPath(root)}\n`);
     }
-  }
-
-  let actions: Array<InstallAction | UninstallAction>;
-  if (installOpts.uninstall) {
-    actions = buildUninstallPlan(root, paths, installOpts);
-  } else if (installOpts.reinstall) {
-    actions = buildUpdatePlan(root, paths, installOpts);
-  } else {
-    actions = buildInstallPlan(root, paths, installOpts);
-  }
-
-  const installActions = actions.filter(
-    (a): a is InstallAction => "kind" in a && typeof a.kind === "string" && a.kind.includes("-mcp"),
-  );
-  if (!installOpts.uninstall && resolveCapabilities(root).mcp && installActions.length > 0) {
-    runTargetPreflight(root, paths, installOpts, installActions);
-  }
-
-  mergeMutationSummary(summary, executePlan(root, actions, installOpts, true));
 
-  if (opts.refresh) {
-    await runConfigureLifecycleHook(root.configure?.afterRefresh, root, paths, !!installOpts.dry);
+    const actions = buildUpdatePlan(root, paths, installOpts);
+    executePlan(actions);
+    runInstallWizard(root);
+    await runConfigureLifecycleHook(root.configure?.afterInstall, root, paths);
+  } catch (err) {
+    installErr(err instanceof Error ? err.message : String(err));
+    process.exit(1);
   }
 
-  return summary;
+  process.exit(0);
 }
 
-/** Main configure command orchestrator. */
-export async function cliConfigure(root: CliProgram, rawOpts: Record<string, string>): Promise<never> {
-  const opts = parseConfigureOpts(rawOpts);
-  const err = validateConfigureOpts(opts);
-  if (err) {
-    installErr(err);
-    process.exit(1);
-  }
+/** Removes agent artifacts and app config. */
+export async function cliConfigureUninstall(root: CliProgram, opts: { yes?: boolean }): Promise<never> {
+  const paths = resolveInstallPaths(root);
+  const uninstallOpts: InstallOpts = { uninstall: true, all: true };
 
-  const isInteractive = !opts.refresh && !opts.removeAll && !opts.removeConfig && !opts.status;
+  confirmUninstall(root, !!opts.yes);
 
-  let summary = emptyMutationSummary();
   try {
-    summary = isInteractive ? await runInteractiveConfigure(root, opts) : await runAutomatedConfigure(root, opts);
-  } catch (mutationErr) {
-    installErr(mutationErr instanceof Error ? mutationErr.message : String(mutationErr));
+    await runConfigureLifecycleHook(root.configure?.beforeUninstall, root, paths);
+    const actions = buildUninstallPlan(root, paths, uninstallOpts);
+    executePlan(actions);
+  } catch (err) {
+    installErr(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
 
-  if (opts.json && !opts.status) {
-    process.stdout.write(`${JSON.stringify(summary.paths, null, 2)}\n`);
-    process.exit(0);
-  }
-
-  const closing = formatConfigureMutationSummary(summary, opts);
-  if (!opts.status && closing) {
-    installOut(closing, configureToInstallOpts(opts));
-  }
+  process.exit(0);
+}
 
+/** Prints install status (human or JSON). */
+export function cliConfigureStatus(root: CliProgram, opts: { json?: boolean }): never {
+  printInstallStatus(root, { status: true, json: opts.json });
   process.exit(0);
 }

package/src/core/types.ts

@@ -406,14 +406,13 @@ export interface CliCompletionConfig {
 
 /** Opt-in agent skill install to `~/.agents/skills/<key>/` (default: disabled). */
 export interface CliSkillConfig {
-  /** When `true`, install and refresh the agent skill via `configure --refresh`. Default false when omitted. */
+  /** When `true`, install the agent skill via `configure install`. Default false when omitted. */
   enabled?: boolean;
 }
 
 /** Context for {@link CliConfigureConfig} lifecycle hooks. */
 export interface ConfigureHookContext {
   program: CliProgram;
-  /** When true, the configure run is `--dry` (hook should not write files). */
   dry: boolean;
   paths: {
     agentsSkillDir: string;
@@ -427,12 +426,12 @@ export interface ConfigureHookContext {
 export interface CliConfigureConfig {
   /** When `false`, hide/disable `configure` (default: enabled). */
   enabled?: boolean;
-  /** Per-artifact gates for configure refresh and interactive wizard. See {@link resolveEffectiveInstallTargets}. */
+  /** Per-artifact gates for configure install. See {@link resolveEffectiveInstallTargets}. */
   targets?: CliConfigureTargets;
-  /** Runs after framework artifacts are installed/refreshed (`configure --refresh`). */
-  afterRefresh?: (ctx: ConfigureHookContext) => void | Promise<void>;
-  /** Runs before framework artifacts are removed (`configure --remove-all`). */
-  beforeRemoveAll?: (ctx: ConfigureHookContext) => void | Promise<void>;
+  /** Runs after framework artifacts are installed (`configure install`). */
+  afterInstall?: (ctx: ConfigureHookContext) => void | Promise<void>;
+  /** Runs before framework artifacts are removed (`configure uninstall`). */
+  beforeUninstall?: (ctx: ConfigureHookContext) => void | Promise<void>;
 }
 
 /** Boolean or structured gate for one install artifact. */
@@ -441,7 +440,7 @@ export type InstallTargetSpec =
   | {
       /** When false, artifact is never installed (even with scoped CLI flags). Default true. */
       enabled?: boolean;
-      /** When true, included in `configure --refresh`. Default varies by key. */
+      /** When true, included in `configure install`. Default varies by key. */
       includedInAll?: boolean;
     };
 

package/src/docs/docs.test.ts

@@ -153,7 +153,7 @@ test("docs mcp when MCP enabled", async () => {
   expect(result.stdout).toContain("MCP server (myapp)");
   expect(result.stdout).toContain("myapp mcp");
   expect(result.stdout).toContain("claude_desktop_config.json");
-  expect(result.stdout).toContain("configure --refresh --yes");
+  expect(result.stdout).toContain("configure install");
 });
 
 test("docs rejects unknown subcommand", async () => {
@@ -304,7 +304,7 @@ test("generateMcpGuide includes schema URI and .agents install", () => {
   expect(guide).toContain("claude_desktop_config.json");
   expect(guide).toContain("## Installation");
   expect(guide).toContain("## Running directly");
-  expect(guide).toContain("configure --refresh");
+  expect(guide).toContain("configure install");
   expect(guide).toContain("dotagentsprotocol.com");
   expect(guide).not.toContain("OpenAI Codex");
 });

package/src/docs/mcp-guide.ts

@@ -81,7 +81,7 @@ export function generateMcpGuide(root: CliProgram): string {
     "",
     "### `.agents` auto-install",
     "",
-    "When `mcpServer.enabled` is set, `configure --refresh` merges this server into `~/.agents/mcp.json` per the https://dotagentsprotocol.com.",
+    "When `mcpServer.enabled` is set, `configure install` merges this server into `~/.agents/mcp.json` per the https://dotagentsprotocol.com.",
     "",
   ];
 
@@ -93,7 +93,7 @@ export function generateMcpGuide(root: CliProgram): string {
 
   lines.push(
     "```bash",
-    `${root.key} configure --refresh --yes`,
+    `${root.key} configure install`,
     "```",
     "",
     "Writes or updates `~/.agents/mcp.json` with a `mcpServers` entry for this app.",

package/src/skill/generate.ts

@@ -154,7 +154,7 @@ function buildSkillMd(root: CliProgram, dirName: string): string {
     "",
     "Install follows the https://dotagentsprotocol.com:",
     "",
-    `- Auto-install: \`${root.key} configure --refresh --yes\` when \`skill.enabled\` → \`~/.agents/skills/${dirName}/\``,
+    `- Auto-install: \`${root.key} configure install\` when \`skill.enabled\` → \`~/.agents/skills/${dirName}/\``,
     `- Cursor and most coding agents read \`~/.agents/skills/\` natively`,
     "",
     "**Claude Code (manual):** symlink or copy into Claude's skill directory:",

package/src/skill/install.ts

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import type { CliProgram } from "../core/types.ts";
-import { userHome } from "../paths/host.ts";
+import { displayHomePath, userHome } from "../paths/host.ts";
 import { generateSkillBundle } from "./generate.ts";
 import { applySkillInstallHints } from "./hint.ts";
 import { skillDirName } from "./naming.ts";
@@ -40,6 +40,7 @@ export function cliSkillInstall(root: CliProgram, opts: SkillInstallOpts): strin
     writeFileSync(skillPath, skillMd, "utf8");
     writeFileSync(skillCompatPath, skillMd, "utf8");
     writeFileSync(refPath, referenceMd, "utf8");
+    process.stdout.write(`Installed skill to ${displayHomePath(dir)}/\n`);
   }
 
   changed.push(skillPath, skillCompatPath, refPath);