ai agent

test/agentSkill.test.mjs

@@ -56,6 +56,32 @@ test("SKILL.md scopes itself to SAGE/RA3 projects and warns off others", async (
   }
 });
 
+test("SKILL.md explains how to reach the index without MCP", async () => {
+  const dir = mkdtempSync(join(tmpdir(), "ra3-skill-reach-"));
+  try {
+    const skillDir = join(dir, "ra3-mod-xml");
+    await writeSkillTo(skillDir, "0.1.25");
+    const content = readFileSync(join(skillDir, "SKILL.md"), "utf8");
+
+    assert.match(content, /## Reaching the index/);
+    // The discovery manifest is the stable entry point.
+    assert.ok(content.includes("~/.ra3modxml/index.json"));
+    // The launcher and the bundled CLI are both mentioned.
+    assert.ok(content.includes("ra3-mod-xml-mcp"));
+    assert.ok(content.includes("cli.js"));
+    // The stdio escape hatch must be shown, since it needs no setup at all.
+    assert.ok(content.includes("tools/call"));
+    // It must not pretend configuring a client takes effect immediately.
+    assert.ok(content.includes("new session"));
+    // And it must refuse to invent results.
+    assert.match(content, /Never fabricate index results/);
+    // Instructions must not send it looking for project-specific docs.
+    assert.equal(content.includes("codebase-navigation-guide"), false);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
 test("installSkillToDirectories records managed copies and uninstall removes them", async () => {
   const home = mkdtempSync(join(tmpdir(), "ra3-skill-home-"));
   const dir = mkdtempSync(join(tmpdir(), "ra3-skill-target-"));