@systemdox/mcp-server 0.1.50 → 0.1.51

package/dist/cli.js

@@ -1828,6 +1828,7 @@ __export(setup_mcp_exports, {
   writeServerEntry: () => writeServerEntry
 });
 import { existsSync as existsSync3, readFileSync } from "fs";
+import { mkdir as mkdir4 } from "fs/promises";
 import { join as join4 } from "path";
 async function validateApiKey(apiKey, apiUrl) {
   try {
@@ -1955,6 +1956,7 @@ async function setupMcpServer(opts) {
   }
   try {
     if ((await readCredentials())[workspace]?.apiKey !== apiKey) await writeCredentials(workspace, apiKey);
+    await mkdir4(join4(homeDir(), ".claude", "skills"), { recursive: true });
     const several = Object.keys(await readCredentials()).length > 1;
     for (const target of selected) {
       const removed = await writeServerEntry(target.path, apiUrl, several ? workspace : void 0);
@@ -2000,7 +2002,7 @@ var init_setup_mcp = __esm({
 
 // src/lib/skills.ts
 import { createHash as createHash3 } from "crypto";
-import { lstat, mkdir as mkdir4, readdir as readdir3, readFile as readFile4, rm as rm3, writeFile as writeFile4 } from "fs/promises";
+import { lstat, mkdir as mkdir5, readdir as readdir3, readFile as readFile4, rm as rm3, writeFile as writeFile4 } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
 import { homedir as homedir2 } from "os";
 import { dirname as dirname4, join as join5, relative, resolve as resolve3, sep } from "path";
@@ -2125,7 +2127,7 @@ async function installSkill(version, dest, { overwrite = false } = {}) {
   const written = [];
   for (const f of version.files) {
     const full = within(dest, f.path);
-    await mkdir4(dirname4(full), { recursive: true });
+    await mkdir5(dirname4(full), { recursive: true });
     await writeFile4(full, f.content, "utf8");
     written.push(f.path);
   }
@@ -2160,6 +2162,9 @@ function fenceFor(text3) {
   const longest = Math.max(0, ...(text3.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -2169,7 +2174,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join5(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 var MANIFEST_FILE, ENTRY_FILE, PLUGIN_MANIFEST_FOLDER, MAX_FILES, MAX_FILE_BYTES, MAX_TOTAL_BYTES, NAME_RE, SEGMENT_RE, SKIPPED, SkillInstallRefused;
@@ -2296,7 +2301,7 @@ __export(plugin_path_exports, {
 });
 import { createHash as createHash4, randomBytes } from "crypto";
 import { existsSync as existsSync5 } from "fs";
-import { mkdir as mkdir5, rename as rename2, writeFile as writeFile5 } from "fs/promises";
+import { mkdir as mkdir6, rename as rename2, writeFile as writeFile5 } from "fs/promises";
 import { dirname as dirname5, join as join6, resolve as resolve5, sep as sep2 } from "path";
 import { inflateRawSync } from "zlib";
 function parsePluginPathArgs(argv) {
@@ -2394,13 +2399,13 @@ async function unpackZip(zip, dest) {
     return full;
   });
   const data = entries2.map((e) => e.directory ? void 0 : entryData(zip, e));
-  await mkdir5(root, { recursive: true });
+  await mkdir6(root, { recursive: true });
   for (const [i, entry] of entries2.entries()) {
     if (entry.directory) {
-      await mkdir5(targets[i], { recursive: true });
+      await mkdir6(targets[i], { recursive: true });
       continue;
     }
-    await mkdir5(dirname5(targets[i]), { recursive: true });
+    await mkdir6(dirname5(targets[i]), { recursive: true });
     await writeFile5(targets[i], data[i], { mode: entry.mode ?? 420 });
   }
   return entries2.filter((e) => !e.directory).length;
@@ -4953,7 +4958,7 @@ ${fence}
 ${f.content}${f.content.endsWith("\n") ? "" : "\n"}${fence}`;
       }).join("\n\n");
       return text(
-        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content, and tell the user to start a new Claude Code session.
+        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content. ${afterInstall(`${dest}/SKILL.md`)}
 
 ### ${MANIFEST_FILE}
 
@@ -5229,7 +5234,7 @@ var init_server = __esm({
     init_create_prompt_template();
     init_skills2();
     init_team_setup();
-    SERVER_VERSION = true ? "0.1.50" : "0.0.0-dev";
+    SERVER_VERSION = true ? "0.1.51" : "0.0.0-dev";
   }
 });
 

package/dist/http.js

@@ -466,6 +466,9 @@ function fenceFor(text3) {
   const longest = Math.max(0, ...(text3.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -475,7 +478,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 
@@ -2841,7 +2844,7 @@ ${fence}
 ${f.content}${f.content.endsWith("\n") ? "" : "\n"}${fence}`;
       }).join("\n\n");
       return text(
-        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content, and tell the user to start a new Claude Code session.
+        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content. ${afterInstall(`${dest}/SKILL.md`)}
 
 ### ${MANIFEST_FILE}
 
@@ -3887,7 +3890,7 @@ function registerTeamSetupTools(server, apiClient, { localFiles }) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.50" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.51" : "0.0.0-dev";
 function createServer(apiClient, { localFiles = false, instructions, keyProblem } = {}) {
   const server = new McpServer(
     {

package/dist/index.js

@@ -447,6 +447,9 @@ function fenceFor(text3) {
   const longest = Math.max(0, ...(text3.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -456,7 +459,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 
@@ -2860,7 +2863,7 @@ ${fence}
 ${f.content}${f.content.endsWith("\n") ? "" : "\n"}${fence}`;
       }).join("\n\n");
       return text(
-        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content, and tell the user to start a new Claude Code session.
+        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content. ${afterInstall(`${dest}/SKILL.md`)}
 
 ### ${MANIFEST_FILE}
 
@@ -3906,7 +3909,7 @@ function registerTeamSetupTools(server, apiClient2, { localFiles }) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.50" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.51" : "0.0.0-dev";
 function createServer(apiClient2, { localFiles = false, instructions, keyProblem: keyProblem2 } = {}) {
   const server = new McpServer(
     {

package/dist/install-skill.js

@@ -385,6 +385,9 @@ async function installSkill(version, dest, { overwrite = false } = {}) {
     keptEdited
   };
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -394,7 +397,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 

package/dist/lib/skills.d.ts

@@ -103,5 +103,12 @@ export declare function installSkill(version: SkillVersionFiles, dest: string, {
 }): Promise<InstallResult>;
 /** A fence longer than any backtick run in `text`, so content cannot close it. */
 export declare function fenceFor(text: string): string;
+/**
+ * What follows an install. Claude Code watches its skills folders, so a running
+ * session needs no restart, unless the top-level folder did not exist when the
+ * session started (code.claude.com/docs/en/skills, "Edit a skill during a
+ * session"): `/reload-skills` covers that, and reading the file works anywhere.
+ */
+export declare function afterInstall(skillMd: string): string;
 /** Human summary of an install, shared by the tool and the CLI. */
 export declare function describeInstall(name: string, r: InstallResult): string;

package/dist/lib/skills.js

@@ -182,6 +182,9 @@ function fenceFor(text) {
   const longest = Math.max(0, ...(text.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -191,7 +194,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 export {
@@ -201,6 +204,7 @@ export {
   MAX_FILE_BYTES,
   MAX_TOTAL_BYTES,
   SkillInstallRefused,
+  afterInstall,
   defaultSkillDir,
   describeInstall,
   fenceFor,

package/dist/server.js

@@ -1607,6 +1607,9 @@ function fenceFor(text3) {
   const longest = Math.max(0, ...(text3.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -1616,7 +1619,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 
@@ -2498,7 +2501,7 @@ ${fence}
 ${f.content}${f.content.endsWith("\n") ? "" : "\n"}${fence}`;
       }).join("\n\n");
       return text(
-        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content, and tell the user to start a new Claude Code session.
+        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content. ${afterInstall(`${dest}/SKILL.md`)}
 
 ### ${MANIFEST_FILE}
 
@@ -3544,7 +3547,7 @@ function registerTeamSetupTools(server, apiClient, { localFiles }) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "0.1.50" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.1.51" : "0.0.0-dev";
 function createServer(apiClient, { localFiles = false, instructions, keyProblem } = {}) {
   const server = new McpServer(
     {

package/dist/setup-mcp.js

@@ -2,6 +2,7 @@
 
 // src/setup-mcp.ts
 import { existsSync as existsSync3, readFileSync } from "fs";
+import { mkdir as mkdir4 } from "fs/promises";
 import { join as join4 } from "path";
 
 // src/lib/cache.ts
@@ -591,6 +592,7 @@ async function setupMcpServer(opts) {
   }
   try {
     if ((await readCredentials())[workspace]?.apiKey !== apiKey) await writeCredentials(workspace, apiKey);
+    await mkdir4(join4(homeDir(), ".claude", "skills"), { recursive: true });
     const several = Object.keys(await readCredentials()).length > 1;
     for (const target of selected) {
       const removed = await writeServerEntry(target.path, apiUrl, several ? workspace : void 0);

package/dist/tools/skills.js

@@ -203,6 +203,9 @@ function fenceFor(text2) {
   const longest = Math.max(0, ...(text2.match(/`+/g) ?? []).map((r) => r.length));
   return "`".repeat(Math.max(3, longest + 1));
 }
+function afterInstall(skillMd) {
+  return `No restart is needed: a running Claude Code session picks it up. If one does not list it yet, read ${skillMd} and follow it, or run /reload-skills.`;
+}
 function describeInstall(name, r) {
   const lines = [
     `Installed ${name} version ${r.version} into ${r.dest} (${r.written.length} file(s)).`
@@ -212,7 +215,7 @@ function describeInstall(name, r) {
     lines.push(`Kept, edited here and no longer in the skill: ${r.keptEdited.join(", ")}`);
   }
   if (r.keptUntracked.length) lines.push(`Kept, added here: ${r.keptUntracked.join(", ")}`);
-  lines.push("Start a new Claude Code session to load it.");
+  lines.push(afterInstall(join(r.dest, "SKILL.md")));
   return lines.join("\n");
 }
 
@@ -342,7 +345,7 @@ ${fence}
 ${f.content}${f.content.endsWith("\n") ? "" : "\n"}${fence}`;
       }).join("\n\n");
       return text(
-        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content, and tell the user to start a new Claude Code session.
+        `Skill **${version.name}** version ${version.version}: write these ${version.files.length} file(s) into ${dest}/ exactly as shown (the content between the fences), creating folders as needed. If a file there differs from ${MANIFEST_FILE}'s hash for it, it was edited: ask before replacing it. Then write ${MANIFEST_FILE} with this content. ${afterInstall(`${dest}/SKILL.md`)}
 
 ### ${MANIFEST_FILE}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@systemdox/mcp-server",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "mcpName": "io.github.puglieseweb/systemdox",
   "type": "module",
   "description": "Give AI coding agents your architecture context over MCP — checks, specs, ADRs, project rules, and docs from SystemDox, delivered at write time",