geo-ai-search-optimization 1.0.1 → 1.0.2

package/README.md

@@ -28,12 +28,18 @@ geo-ai-search-optimization install
 geo-ai-search-optimization install --target ./tmp/custom-skills --json
 geo-ai-search-optimization where
 geo-ai-search-optimization doctor
+geo-ai-search-optimization init-llms ./site --site-name "Acme Docs" --site-url "https://example.com"
 geo-ai-search-optimization scan ./my-site --max-file-size 500000 --max-examples 3
 geo-ai-search-optimization scan ./my-site --json --out ./reports/geo-scan.json
 geo-ai-search-optimization version
 geo-ai-search-optimization help
 ```
 
+## New in 1.0.2
+
+- `init-llms` command for generating an `llms.txt` starter template
+- keeps the `1.0.1` CLI upgrades: `doctor`, custom `install --target`, and richer `scan` output controls
+
 ## New in 1.0.1
 
 - `doctor` command for installation and environment checks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Install and run a GEO-first, SEO-supported Codex skill for AI search optimization.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -5,6 +5,7 @@ import { installSkill } from "./install-skill.js";
 import { getBundledSkillPath, getInstalledSkillPath, getSkillName, getSkillsDir } from "./paths.js";
 import { renderScanMarkdown, scanProject, writeScanOutput } from "./scan.js";
 import { renderDoctorMarkdown, runDoctor } from "./doctor.js";
+import { createLlmsTxt } from "./llms-txt.js";
 
 let cachedVersion;
 
@@ -29,6 +30,7 @@ function printHelp() {
       "  geo-ai-search-optimization install [--target <dir>] [--json]",
       "  geo-ai-search-optimization where",
       "  geo-ai-search-optimization doctor [--json]",
+      "  geo-ai-search-optimization init-llms [target-dir] [--site-name <name>] [--site-url <url>] [--overwrite] [--json]",
       "  geo-ai-search-optimization scan <project-path> [--json] [--out <file>] [--max-file-size <bytes>] [--max-examples <count>]",
       "  geo-ai-search-optimization version",
       "  geo-ai-search-optimization help",
@@ -123,6 +125,24 @@ async function handleScan(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleInitLlms(args) {
+  const targetDir = args.find((value) => !value.startsWith("-")) || ".";
+  const outputJson = hasFlag(args, "--json");
+  const result = await createLlmsTxt({
+    targetDir,
+    siteName: getFlagValue(args, "--site-name"),
+    siteUrl: getFlagValue(args, "--site-url"),
+    overwrite: hasFlag(args, "--overwrite")
+  });
+
+  if (outputJson) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+
+  process.stdout.write(`Created llms.txt at ${result.outputPath}\n`);
+}
+
 export async function runCli(args = []) {
   const [command = "install", ...rest] = args;
 
@@ -151,6 +171,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "init-llms") {
+    await handleInitLlms(rest);
+    return;
+  }
+
   if (command === "scan") {
     await handleScan(rest);
     return;

package/src/index.js

@@ -1,4 +1,5 @@
 export { installSkill } from "./install-skill.js";
 export { runCli } from "./cli.js";
 export { runDoctor, renderDoctorMarkdown } from "./doctor.js";
+export { createLlmsTxt } from "./llms-txt.js";
 export { scanProject, renderScanMarkdown, writeScanOutput } from "./scan.js";

package/src/llms-txt.js

@@ -0,0 +1,76 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+async function pathExists(targetPath) {
+  try {
+    await fs.access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function buildLlmsTxtContent({ siteName, siteUrl }) {
+  const resolvedSiteName = siteName || "Your Site Name";
+  const resolvedSiteUrl = siteUrl || "https://example.com";
+
+  return [
+    `# ${resolvedSiteName}`,
+    "",
+    `> GEO-first site profile for AI assistants and answer engines.`,
+    "",
+    `Canonical: ${resolvedSiteUrl}`,
+    "",
+    "## About",
+    "",
+    "- Summarize what this site does in 1-2 sentences.",
+    "- Describe the primary audience and core use cases.",
+    "- Mention what makes the content or product uniquely trustworthy.",
+    "",
+    "## Priority URLs",
+    "",
+    `- ${resolvedSiteUrl}/`,
+    `- ${resolvedSiteUrl}/pricing`,
+    `- ${resolvedSiteUrl}/docs`,
+    `- ${resolvedSiteUrl}/blog`,
+    "",
+    "## Recommended Sources",
+    "",
+    "- Link to pages with first-party research, methodology, benchmarks, or clear product facts.",
+    "- Prefer canonical pages over campaign or temporary URLs.",
+    "",
+    "## AI Assistant Guidance",
+    "",
+    "- Use the latest canonical URLs when citing this site.",
+    "- Prefer pages with explicit dates, authors, reviewers, or methodology notes.",
+    "- Avoid summarizing outdated pages when newer versions exist.",
+    "",
+    "## Update Policy",
+    "",
+    "- Replace this section with the site’s actual content freshness and review cadence.",
+    ""
+  ].join("\n");
+}
+
+export async function createLlmsTxt(options = {}) {
+  const targetDir = path.resolve(options.targetDir || ".");
+  const outputPath = path.join(targetDir, "llms.txt");
+  const overwrite = Boolean(options.overwrite);
+
+  if (!overwrite && (await pathExists(outputPath))) {
+    throw new Error(`llms.txt already exists at ${outputPath}. Use --overwrite to replace it.`);
+  }
+
+  await fs.mkdir(targetDir, { recursive: true });
+  const content = buildLlmsTxtContent({
+    siteName: options.siteName,
+    siteUrl: options.siteUrl
+  });
+  await fs.writeFile(outputPath, content, "utf8");
+
+  return {
+    outputPath,
+    siteName: options.siteName || "Your Site Name",
+    siteUrl: options.siteUrl || "https://example.com"
+  };
+}