agdex 0.2.0 → 0.3.1

package/dist/cli/index.js

@@ -3,14 +3,18 @@ import {
   __commonJS,
   __require,
   __toESM,
+  basedpyrightProvider,
   buildDocTree,
   bunProvider,
   collectAllSkills,
   collectDocFiles,
+  convexProvider,
   createProvider,
+  deltaRsProvider,
   embed,
   embedSkills,
   generateIndex,
+  getDefaultOutput,
   getDefaultSkillSources,
   getProvider,
   hasExistingIndex,
@@ -20,11 +24,16 @@ import {
   listProviders,
   nextjsProvider,
   pixiProvider,
+  polarsProvider,
   rattlerBuildProvider,
   removeDocsIndex,
   removeSkillsIndex,
-  tauriProvider
-} from "../index-cfpc7eqp.js";
+  ruffProvider,
+  svelteProvider,
+  tailwindProvider,
+  tauriProvider,
+  tyProvider
+} from "../index-zrmn6fd2.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
@@ -6918,7 +6927,7 @@ async function runEmbed(options) {
       provider = result.provider;
       version = result.version;
       output = result.output;
-      await executeEmbed(cwd, provider, version, output, options.global);
+      await executeEmbed(cwd, provider, version, output, options.global, result.description);
       return;
     }
   } else {
@@ -6926,17 +6935,17 @@ async function runEmbed(options) {
     provider = result.provider;
     version = result.version;
     output = result.output;
-    await executeEmbed(cwd, provider, version, output, options.global);
+    await executeEmbed(cwd, provider, version, output, options.global, result.description);
     return;
   }
-  output = options.output || "AGENTS.md";
+  output = options.output || getDefaultOutput();
   if (!version && !provider.detectVersion) {
     console.error(import_picocolors.default.red(`Provider ${provider.displayName} requires --version flag since auto-detection is not supported.`));
     process.exit(1);
   }
-  await executeEmbed(cwd, provider, version, output, options.global);
+  await executeEmbed(cwd, provider, version, output, options.global, options.description);
 }
-async function executeEmbed(cwd, provider, version, output, globalCache) {
+async function executeEmbed(cwd, provider, version, output, globalCache, description) {
   let resolvedVersion = version;
   if (!resolvedVersion && provider.detectVersion) {
     const detected = provider.detectVersion(cwd);
@@ -6954,7 +6963,8 @@ Downloading ${import_picocolors.default.cyan(provider.displayName)} ${import_pic
     provider,
     version: resolvedVersion,
     output,
-    globalCache
+    globalCache,
+    description
   });
   if (!result.success) {
     console.error(import_picocolors.default.red(`Failed: ${result.error}`));
@@ -6969,7 +6979,7 @@ Downloading ${import_picocolors.default.cyan(provider.displayName)} ${import_pic
   console.log("");
 }
 function autoDetectProvider(cwd) {
-  const providers = [nextjsProvider, pixiProvider, rattlerBuildProvider, tauriProvider, bunProvider];
+  const providers = [nextjsProvider, pixiProvider, rattlerBuildProvider, tauriProvider, bunProvider, svelteProvider, tailwindProvider, ruffProvider, tyProvider, basedpyrightProvider, convexProvider, polarsProvider, deltaRsProvider];
   for (const provider of providers) {
     if (provider.detectVersion) {
       const result = provider.detectVersion(cwd);
@@ -6980,62 +6990,172 @@ function autoDetectProvider(cwd) {
   }
   return null;
 }
+function parseGitHubInput(input) {
+  input = input.trim();
+  if (/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(input)) {
+    return { repo: input };
+  }
+  const urlMatch = input.match(/^https?:\/\/github\.com\/([a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+)(?:\/(?:tree|blob)\/([^/]+)(?:\/(.+))?)?/);
+  if (urlMatch) {
+    return {
+      repo: urlMatch[1],
+      branch: urlMatch[2] || undefined,
+      path: urlMatch[3] || undefined
+    };
+  }
+  return null;
+}
+async function detectRepoContent(repo, branch) {
+  const result = {
+    hasDocs: false,
+    hasReadme: false,
+    hasSkills: false,
+    docsPath: undefined,
+    skillsPath: undefined,
+    defaultBranch: branch || "main"
+  };
+  const { execSync } = await import("child_process");
+  try {
+    if (!branch) {
+      try {
+        const repoInfo = execSync(`gh api repos/${repo} --jq '.default_branch'`, {
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "pipe"]
+        }).trim();
+        result.defaultBranch = repoInfo || "main";
+      } catch {
+        result.defaultBranch = "main";
+      }
+    }
+    const contents = execSync(`gh api repos/${repo}/contents?ref=${result.defaultBranch} --jq '.[].name'`, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim().split(`
+`);
+    const docsDirectories = ["docs", "doc", "documentation"];
+    for (const dir of docsDirectories) {
+      if (contents.includes(dir)) {
+        result.hasDocs = true;
+        result.docsPath = dir;
+        break;
+      }
+    }
+    const readmeFiles = ["README.md", "README.mdx", "readme.md", "Readme.md"];
+    for (const readme of readmeFiles) {
+      if (contents.includes(readme)) {
+        result.hasReadme = true;
+        break;
+      }
+    }
+    const skillsDirectories = ["skills", ".claude/skills"];
+    for (const dir of skillsDirectories) {
+      if (contents.includes(dir) || contents.includes(dir.split("/")[0])) {
+        result.hasSkills = true;
+        result.skillsPath = dir;
+        break;
+      }
+    }
+  } catch {}
+  return result;
+}
 async function promptForOptions(cwd) {
   const detected = autoDetectProvider(cwd);
   console.log(import_picocolors.default.cyan(`
 agdex - Documentation Index for AI Coding Agents
+`));
+  console.log(import_picocolors.default.gray("  Create compressed documentation indexes for AI coding assistants."));
+  console.log(import_picocolors.default.gray(`  Indexes are embedded into AGENTS.md/CLAUDE.md files.
 `));
   if (detected) {
-    console.log(import_picocolors.default.gray(`  Detected ${detected.provider.displayName} version: ${detected.version}
+    console.log(import_picocolors.default.green(`  ✓ Detected ${detected.provider.displayName} v${detected.version}
 `));
   }
+  const actionResponse = await import_prompts.default({
+    type: "select",
+    name: "action",
+    message: "What would you like to index?",
+    choices: [
+      ...detected ? [{
+        title: `${detected.provider.displayName} docs (detected)`,
+        value: "detected",
+        description: `Index ${detected.provider.displayName} v${detected.version} documentation`
+      }] : [],
+      {
+        title: "Built-in provider",
+        value: "provider",
+        description: "Next.js, React, Pixi, Bun, Tauri, etc."
+      },
+      {
+        title: "GitHub repository",
+        value: "github",
+        description: "Enter a GitHub URL or owner/repo"
+      },
+      {
+        title: "Local directory",
+        value: "local",
+        description: "Index docs from a local folder"
+      },
+      {
+        title: "Skills",
+        value: "skills",
+        description: "Index Claude Code skills"
+      }
+    ],
+    initial: detected ? 0 : 0
+  }, { onCancel });
+  if (actionResponse.action === "detected" && detected) {
+    const output2 = await promptForOutputFile();
+    const description2 = await promptForDescription();
+    return {
+      provider: detected.provider,
+      version: detected.version,
+      output: output2,
+      description: description2
+    };
+  }
+  if (actionResponse.action === "local") {
+    const localResponse = await import_prompts.default({
+      type: "text",
+      name: "path",
+      message: "Path to documentation directory",
+      initial: "./docs",
+      validate: (v) => {
+        if (!v.trim())
+          return "Please enter a path";
+        const absPath = path.isAbsolute(v) ? v : path.join(cwd, v);
+        if (!fs.existsSync(absPath))
+          return `Directory not found: ${v}`;
+        return true;
+      }
+    }, { onCancel });
+    const nameResponse = await import_prompts.default({
+      type: "text",
+      name: "name",
+      message: "Display name",
+      initial: path.basename(localResponse.path)
+    }, { onCancel });
+    const output2 = await promptForOutputFile();
+    await runLocal(localResponse.path, { name: nameResponse.name, output: output2 });
+    process.exit(0);
+  }
+  if (actionResponse.action === "skills") {
+    await runSkillsEmbed({});
+    process.exit(0);
+  }
+  if (actionResponse.action === "github") {
+    return await promptForGitHubRepo(cwd);
+  }
   const availableProviders = listProviders().filter(isProviderAvailable);
   const response = await import_prompts.default([
     {
       type: "select",
       name: "provider",
       message: "Documentation provider",
-      choices: [
-        ...availableProviders.map((p) => ({
-          title: getProvider(p).displayName,
-          value: p
-        })),
-        { title: "Custom GitHub repo...", value: "__custom__" }
-      ],
+      choices: availableProviders.map((p) => ({
+        title: getProvider(p).displayName,
+        value: p
+      })),
       initial: detected ? availableProviders.indexOf(detected.provider.name) : 0
     }
   ], { onCancel });
-  let provider;
-  if (response.provider === "__custom__") {
-    const customResponse = await import_prompts.default([
-      {
-        type: "text",
-        name: "repo",
-        message: "GitHub repository (owner/repo)",
-        validate: (v) => v.includes("/") ? true : "Format: owner/repo"
-      },
-      {
-        type: "text",
-        name: "docsPath",
-        message: "Path to docs folder",
-        initial: "docs"
-      },
-      {
-        type: "text",
-        name: "displayName",
-        message: "Display name",
-        initial: "Custom"
-      }
-    ], { onCancel });
-    provider = createProvider({
-      name: "custom",
-      displayName: customResponse.displayName,
-      repo: customResponse.repo,
-      docsPath: customResponse.docsPath
-    });
-  } else {
-    provider = getProvider(response.provider);
-  }
+  const provider = getProvider(response.provider);
   let initialVersion = "";
   if (provider.detectVersion) {
     const detectedVersion = provider.detectVersion(cwd);
@@ -7043,42 +7163,199 @@ agdex - Documentation Index for AI Coding Agents
       initialVersion = detectedVersion.version;
     }
   }
-  const versionResponse = await import_prompts.default([
-    {
-      type: "text",
-      name: "version",
-      message: `${provider.displayName} version`,
-      initial: initialVersion,
-      validate: (v) => v.trim() ? true : "Please enter a version"
-    },
-    {
-      type: "select",
-      name: "output",
-      message: "Target file",
-      choices: [
-        { title: "AGENTS.md", value: "AGENTS.md" },
-        { title: "CLAUDE.md", value: "CLAUDE.md" },
-        { title: "Custom...", value: "__custom__" }
-      ],
-      initial: 0
-    }
-  ], { onCancel });
-  let output = versionResponse.output;
-  if (output === "__custom__") {
+  const versionResponse = await import_prompts.default({
+    type: "text",
+    name: "version",
+    message: `${provider.displayName} version`,
+    initial: initialVersion,
+    validate: (v) => v.trim() ? true : "Please enter a version"
+  }, { onCancel });
+  const output = await promptForOutputFile();
+  const description = await promptForDescription();
+  return {
+    provider,
+    version: versionResponse.version,
+    output,
+    description
+  };
+}
+async function promptForOutputFile() {
+  const defaultOutput = getDefaultOutput();
+  const choices = [
+    { title: "AGENTS.md", value: "AGENTS.md" },
+    { title: "CLAUDE.md", value: "CLAUDE.md" },
+    { title: "Custom...", value: "__custom__" }
+  ];
+  const defaultIndex = choices.findIndex((c) => c.value === defaultOutput);
+  const initial = defaultIndex >= 0 ? defaultIndex : 0;
+  const response = await import_prompts.default({
+    type: "select",
+    name: "output",
+    message: "Target file",
+    choices,
+    initial
+  }, { onCancel });
+  if (response.output === "__custom__") {
     const customOutput = await import_prompts.default({
       type: "text",
       name: "file",
       message: "Custom file path",
-      initial: "AGENTS.md",
+      initial: defaultOutput,
       validate: (v) => v.trim() ? true : "Please enter a file path"
     }, { onCancel });
-    output = customOutput.file;
+    return customOutput.file;
   }
-  return {
-    provider,
-    version: versionResponse.version,
-    output
-  };
+  return response.output;
+}
+async function promptForDescription() {
+  const response = await import_prompts.default({
+    type: "text",
+    name: "description",
+    message: "Additional description (optional, press Enter to skip)",
+    initial: ""
+  }, { onCancel });
+  return response.description?.trim() || undefined;
+}
+async function promptForGitHubRepo(cwd) {
+  console.log("");
+  console.log(import_picocolors.default.gray("  Enter a GitHub URL or owner/repo. Examples:"));
+  console.log(import_picocolors.default.gray("    • anthropics/skills"));
+  console.log(import_picocolors.default.gray("    • https://github.com/vercel/next.js"));
+  console.log(import_picocolors.default.gray("    • https://github.com/anthropics/skills/tree/main/skills"));
+  console.log("");
+  const urlResponse = await import_prompts.default({
+    type: "text",
+    name: "url",
+    message: "GitHub repository",
+    validate: (v) => {
+      if (!v.trim())
+        return "Please enter a URL or owner/repo";
+      const parsed2 = parseGitHubInput(v);
+      if (!parsed2)
+        return "Invalid format. Use owner/repo or a GitHub URL";
+      return true;
+    }
+  }, { onCancel });
+  const parsed = parseGitHubInput(urlResponse.url);
+  console.log(`
+${import_picocolors.default.gray("Checking repository contents...")}`);
+  const repoContent = await detectRepoContent(parsed.repo, parsed.branch);
+  if (parsed.path) {
+    console.log(import_picocolors.default.green(`  ✓ Using specified path: ${parsed.path}
+`));
+    const nameResponse2 = await import_prompts.default({
+      type: "text",
+      name: "name",
+      message: "Display name",
+      initial: path.basename(parsed.path) || parsed.repo.split("/")[1]
+    }, { onCancel });
+    const versionResponse2 = await import_prompts.default({
+      type: "text",
+      name: "version",
+      message: 'Version/tag (or "latest" for default branch)',
+      initial: parsed.branch || repoContent.defaultBranch
+    }, { onCancel });
+    const output2 = await promptForOutputFile();
+    const description2 = await promptForDescription();
+    const provider2 = createProvider({
+      name: nameResponse2.name.toLowerCase().replace(/\s+/g, "-"),
+      displayName: nameResponse2.name,
+      repo: parsed.repo,
+      docsPath: parsed.path
+    });
+    return { provider: provider2, version: versionResponse2.version, output: output2, description: description2 };
+  }
+  const detected = [];
+  if (repoContent.hasDocs)
+    detected.push(`docs (${repoContent.docsPath})`);
+  if (repoContent.hasReadme)
+    detected.push("README.md");
+  if (repoContent.hasSkills)
+    detected.push(`skills (${repoContent.skillsPath})`);
+  if (detected.length > 0) {
+    console.log(import_picocolors.default.green(`  ✓ Found: ${detected.join(", ")}
+`));
+  } else {
+    console.log(import_picocolors.default.yellow(`  No standard docs/skills directories detected.
+`));
+  }
+  const choices = [];
+  if (repoContent.hasDocs) {
+    choices.push({
+      title: `Documentation (${repoContent.docsPath}/)`,
+      value: "docs",
+      description: "Index the docs directory"
+    });
+  }
+  if (repoContent.hasReadme) {
+    choices.push({
+      title: "README.md",
+      value: "readme",
+      description: "Index the README file"
+    });
+  }
+  if (repoContent.hasSkills) {
+    choices.push({
+      title: `Skills (${repoContent.skillsPath}/)`,
+      value: "skills",
+      description: "Index Claude Code skills"
+    });
+  }
+  choices.push({
+    title: "Custom path...",
+    value: "custom",
+    description: "Specify a custom path in the repository"
+  });
+  const contentChoice = await import_prompts.default({
+    type: "select",
+    name: "content",
+    message: "What would you like to index?",
+    choices
+  }, { onCancel });
+  let docsPath;
+  let displayName = parsed.repo.split("/")[1];
+  if (contentChoice.content === "docs") {
+    docsPath = repoContent.docsPath;
+    displayName = `${parsed.repo.split("/")[1]} Docs`;
+  } else if (contentChoice.content === "readme") {
+    docsPath = ".";
+    displayName = `${parsed.repo.split("/")[1]} README`;
+  } else if (contentChoice.content === "skills") {
+    console.log(import_picocolors.default.yellow(`
+Skills indexing from GitHub URLs is coming soon!`));
+    console.log(import_picocolors.default.gray(`For now, clone the repo and use: agdex skills local <path>
+`));
+    process.exit(0);
+  } else {
+    const pathResponse = await import_prompts.default({
+      type: "text",
+      name: "path",
+      message: "Path in repository",
+      initial: "docs"
+    }, { onCancel });
+    docsPath = pathResponse.path;
+  }
+  const nameResponse = await import_prompts.default({
+    type: "text",
+    name: "name",
+    message: "Display name",
+    initial: displayName
+  }, { onCancel });
+  const versionResponse = await import_prompts.default({
+    type: "text",
+    name: "version",
+    message: "Version/tag (or branch name for latest)",
+    initial: repoContent.defaultBranch
+  }, { onCancel });
+  const output = await promptForOutputFile();
+  const description = await promptForDescription();
+  const provider = createProvider({
+    name: nameResponse.name.toLowerCase().replace(/\s+/g, "-"),
+    displayName: nameResponse.name,
+    repo: parsed.repo,
+    docsPath
+  });
+  return { provider, version: versionResponse.version, output, description };
 }
 async function runLocal(docsPath, options) {
   const cwd = process.cwd();
@@ -7088,7 +7365,7 @@ async function runLocal(docsPath, options) {
     process.exit(1);
   }
   const name = options.name || path.basename(docsPath);
-  const output = options.output || "AGENTS.md";
+  const output = options.output || getDefaultOutput();
   const extensions = options.extensions?.split(",") || [".md", ".mdx"];
   console.log(`
 Building index from ${import_picocolors.default.cyan(docsPath)}...`);
@@ -7122,7 +7399,7 @@ Building index from ${import_picocolors.default.cyan(docsPath)}...`);
 }
 function runList() {
   console.log(import_picocolors.default.cyan(`
-Available documentation providers:
+\uD83D\uDCDA Built-in Documentation Providers
 `));
   for (const preset of listProviders()) {
     const provider = getProvider(preset);
@@ -7132,17 +7409,40 @@ Available documentation providers:
     console.log(`  ${status} ${import_picocolors.default.bold(preset)} - ${name} (${import_picocolors.default.gray(repo)})`);
   }
   console.log("");
-  console.log(import_picocolors.default.gray("Use --provider <name> to select a provider"));
-  console.log(import_picocolors.default.gray("Use --repo and --docs-path for custom repositories"));
+  console.log(import_picocolors.default.cyan(`\uD83D\uDCE6 Usage Examples
+`));
+  console.log(import_picocolors.default.gray("  Built-in provider:"));
+  console.log(`    ${import_picocolors.default.white("agdex --provider nextjs")}`);
+  console.log("");
+  console.log(import_picocolors.default.gray("  Any GitHub repository:"));
+  console.log(`    ${import_picocolors.default.white("agdex --repo owner/repo --docs-path docs")}`);
+  console.log("");
+  console.log(import_picocolors.default.gray("  GitHub URL with path:"));
+  console.log(`    ${import_picocolors.default.white("agdex")} ${import_picocolors.default.gray("(interactive)")}`);
+  console.log(`    ${import_picocolors.default.gray("→ then enter:")} ${import_picocolors.default.white("https://github.com/anthropics/skills/tree/main/skills")}`);
+  console.log("");
+  console.log(import_picocolors.default.gray("  Local documentation:"));
+  console.log(`    ${import_picocolors.default.white('agdex local ./my-docs --name "My Docs"')}`);
+  console.log("");
+  console.log(import_picocolors.default.gray("  Skills indexing:"));
+  console.log(`    ${import_picocolors.default.white("agdex skills embed")}`);
   console.log("");
 }
-program2.name("agdex").description("Embed compressed documentation indexes into AGENTS.md/CLAUDE.md for AI coding agents").version("0.2.0");
-program2.command("embed", { isDefault: true }).description("Embed documentation index into AGENTS.md/CLAUDE.md").option("-p, --provider <name>", "Documentation provider (nextjs, react, etc.)").option("--fw-version <version>", "Framework version (auto-detected if not provided)").option("-o, --output <file>", "Target file (default: AGENTS.md)").option("--repo <owner/repo>", "Custom GitHub repository").option("--docs-path <path>", "Path to docs folder in repository").option("-g, --global", "Store docs in global cache (~/.cache/agdex/) instead of local .agdex/").action(runEmbed);
-program2.command("local <docs-path>").description("Build index from local documentation directory").option("-n, --name <name>", "Display name for the documentation").option("-o, --output <file>", "Target file (default: AGENTS.md)").option("-e, --extensions <exts>", "File extensions to include (comma-separated, default: .md,.mdx)").action(runLocal);
+program2.name("agdex").description(`Create compressed documentation indexes for AI coding agents.
+
+Sources you can index:
+  • Built-in providers (Next.js, React, Bun, Pixi, Tauri, etc.)
+  • Any GitHub repository URL or owner/repo
+  • Local documentation directories
+  • Claude Code skills
+
+Run 'agdex' without arguments for interactive mode.`).version("0.2.0");
+program2.command("embed", { isDefault: true }).description("Embed documentation index into AGENTS.md/CLAUDE.md").option("-p, --provider <name>", "Documentation provider (nextjs, react, etc.)").option("--fw-version <version>", "Framework version (auto-detected if not provided)").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--repo <owner/repo>", "Custom GitHub repository").option("--docs-path <path>", "Path to docs folder in repository").option("-g, --global", "Store docs in global cache (~/.cache/agdex/) instead of local .agdex/").option("-d, --description <text>", "Additional description to include in the index").action(runEmbed);
+program2.command("local <docs-path>").description("Build index from local documentation directory").option("-n, --name <name>", "Display name for the documentation").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("-e, --extensions <exts>", "File extensions to include (comma-separated, default: .md,.mdx)").action(runLocal);
 program2.command("list").description("List available documentation providers").action(runList);
 function runRemove(options) {
   const cwd = process.cwd();
-  const output = options.output || "AGENTS.md";
+  const output = options.output || getDefaultOutput();
   const targetPath = path.join(cwd, output);
   if (!fs.existsSync(targetPath)) {
     console.error(import_picocolors.default.red(`File not found: ${output}`));
@@ -7182,18 +7482,19 @@ No indices found to remove.
   console.log(import_picocolors.default.gray(`  (${formatSize(sizeBefore)} → ${formatSize(sizeAfter)})`));
   console.log("");
 }
-program2.command("remove").description("Remove embedded indices from AGENTS.md/CLAUDE.md").option("-o, --output <file>", "Target file (default: AGENTS.md)").option("--docs", "Remove only docs index").option("--skills", "Remove only skills index").option("-p, --provider <name>", "Remove only a specific provider's docs index").action(runRemove);
+program2.command("remove").description("Remove embedded indices from AGENTS.md/CLAUDE.md").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--docs", "Remove only docs index").option("--skills", "Remove only skills index").option("-p, --provider <name>", "Remove only a specific provider's docs index").action(runRemove);
 var skillsCommand = program2.command("skills").description("Manage Claude Code skills indexing");
 async function runSkillsEmbed(options) {
   const cwd = process.cwd();
-  const output = options.output || "AGENTS.md";
+  const output = options.output || getDefaultOutput();
   const sources = getDefaultSkillSources(cwd, {
     includeUser: options.user !== false,
     includeProject: options.project !== false,
+    includeEnabledPlugins: options.plugins !== false,
     pluginPaths: options.plugin || []
   });
   if (sources.length === 0) {
-    console.error(import_picocolors.default.red("No skill sources configured. Use --plugin, --user, or --project flags."));
+    console.error(import_picocolors.default.red("No skill sources configured. Use --plugin, --user, --project, or --plugins flags."));
     process.exit(1);
   }
   console.log(`
@@ -7227,6 +7528,7 @@ function runSkillsList(options) {
   const sources = getDefaultSkillSources(cwd, {
     includeUser: options.user !== false,
     includeProject: options.project !== false,
+    includeEnabledPlugins: options.plugins !== false,
     pluginPaths: options.plugin || []
   });
   const skills = collectAllSkills(sources);
@@ -7264,7 +7566,7 @@ async function runSkillsLocal(skillsPath, options) {
     console.error(import_picocolors.default.red(`Skills directory not found: ${skillsPath}`));
     process.exit(1);
   }
-  const output = options.output || "AGENTS.md";
+  const output = options.output || getDefaultOutput();
   const label = options.name || path.basename(skillsPath);
   const hasPluginsDir = fs.existsSync(path.join(absolutePath, "plugins"));
   const sources = [{
@@ -7285,7 +7587,7 @@ Discovering skills from ${import_picocolors.default.cyan(skillsPath)}...`);
   console.log(`${import_picocolors.default.green("✓")} Indexed ${import_picocolors.default.bold(result.skillCount.toString())} skills`);
   console.log("");
 }
-skillsCommand.command("embed").description("Embed skills index into AGENTS.md").option("-o, --output <file>", "Target file (default: AGENTS.md)").option("--plugin <path...>", "Plugin repo paths (with plugins/ structure)").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").action(runSkillsEmbed);
-skillsCommand.command("list").description("List discovered skills").option("--plugin <path...>", "Plugin repo paths (with plugins/ structure)").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").action(runSkillsList);
-skillsCommand.command("local <skills-path>").description("Index skills from a local path").option("-o, --output <file>", "Target file (default: AGENTS.md)").option("-n, --name <name>", "Label for this skill source").action(runSkillsLocal);
+skillsCommand.command("embed").description("Embed skills index into AGENTS.md").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--plugin <path...>", "Additional plugin repo paths (with plugins/ structure)").option("--plugins", "Include enabled plugins from settings.json (default: true)").option("--no-plugins", "Exclude enabled plugins from settings.json").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").action(runSkillsEmbed);
+skillsCommand.command("list").description("List discovered skills").option("--plugin <path...>", "Additional plugin repo paths (with plugins/ structure)").option("--plugins", "Include enabled plugins from settings.json (default: true)").option("--no-plugins", "Exclude enabled plugins from settings.json").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").action(runSkillsList);
+skillsCommand.command("local <skills-path>").description("Index skills from a local path").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("-n, --name <name>", "Label for this skill source").action(runSkillsLocal);
 program2.parse();