@skills-hub-ai/mcp 0.1.8 → 0.1.9

package/dist/api.d.ts

@@ -43,4 +43,11 @@ export interface SkillDetailResult {
 }
 export declare function searchSkills(query: string, category?: string, limit?: number, org?: string): Promise<SkillSearchResult[]>;
 export declare function getSkillDetail(slug: string): Promise<SkillDetailResult>;
+/**
+ * Record a completed install so it counts toward the skill's installCount and
+ * shows up as an MCP install in analytics. Best-effort: a tracking failure must
+ * never break an install that already wrote files locally, so this swallows all
+ * errors. Anonymous (no API token) installs are deduped server-side by IP.
+ */
+export declare function recordInstall(slug: string, target: "claude-code" | "cursor"): Promise<void>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE;QACX,QAAQ,EAAE,KAAK,CAAC;YACd,KAAK,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC;YACnE,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC,CAAC;KACJ,GAAG,IAAI,CAAC;CACV;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,SAAK,EACV,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgB9B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAS7E"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE;QACX,QAAQ,EAAE,KAAK,CAAC;YACd,KAAK,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC;YACnE,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC,CAAC;KACJ,GAAG,IAAI,CAAC;CACV;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,SAAK,EACV,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgB9B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAS7E;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,GAAG,QAAQ,GAC/B,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/api.js

@@ -1,14 +1,18 @@
 const API_URL = process.env.SKILLS_HUB_API_URL || "https://api.skills-hub.ai";
 const API_TOKEN = process.env.SKILLS_HUB_API_TOKEN || "";
 const TIMEOUT_MS = 30_000;
-function fetchWithTimeout(url) {
+function fetchWithTimeout(url, init = {}) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
-    const headers = {};
+    const headers = {
+        // Identifies MCP traffic to the API's analytics (web vs cli vs mcp).
+        "X-Skills-Hub-Client": "mcp",
+        ...(init.headers ?? {}),
+    };
     if (API_TOKEN) {
         headers["Authorization"] = `ApiKey ${API_TOKEN}`;
     }
-    return fetch(url, { signal: controller.signal, headers }).finally(() => clearTimeout(timer));
+    return fetch(url, { ...init, signal: controller.signal, headers }).finally(() => clearTimeout(timer));
 }
 export async function searchSkills(query, category, limit = 10, org) {
     const params = new URLSearchParams({
@@ -34,4 +38,23 @@ export async function getSkillDetail(slug) {
     }
     return (await res.json());
 }
+/**
+ * Record a completed install so it counts toward the skill's installCount and
+ * shows up as an MCP install in analytics. Best-effort: a tracking failure must
+ * never break an install that already wrote files locally, so this swallows all
+ * errors. Anonymous (no API token) installs are deduped server-side by IP.
+ */
+export async function recordInstall(slug, target) {
+    const platform = target === "cursor" ? "CURSOR" : "CLAUDE_CODE";
+    try {
+        await fetchWithTimeout(`${API_URL}/api/v1/skills/${encodeURIComponent(slug)}/install`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ platform }),
+        });
+    }
+    catch {
+        // Swallow — install already succeeded locally; tracking is best-effort.
+    }
+}
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,2BAA2B,CAAC;AAC9E,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;AACzD,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,SAAS,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CACrE,YAAY,CAAC,KAAK,CAAC,CACpB,CAAC;AACJ,CAAC;AAqCD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,QAAiB,EACjB,KAAK,GAAG,EAAE,EACV,GAAY;IAEZ,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,CAAC,EAAE,KAAK;QACR,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;QACpB,IAAI,EAAE,WAAW;KAClB,CAAC,CAAC;IACH,IAAI,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,GAAG;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhC,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,OAAO,kBAAkB,MAAM,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmC,CAAC;IAClE,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAChC,GAAG,OAAO,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;AACjD,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wEAAwE;AACxE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,aAAa,GAAG,QAAwB,GAC/C,OAAO,CAAC,aAAa,CAAC,CA6CxB"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAoDA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wEAAwE;AACxE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,aAAa,GAAG,QAAwB,GAC/C,OAAO,CAAC,aAAa,CAAC,CA4CxB"}

package/dist/installer.js

@@ -1,20 +1,8 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
-import { getSkillDetail } from "./api.js";
-function validateSlug(slug) {
-    if (!slug || /[/\\]|\.\./.test(slug)) {
-        throw new Error(`Invalid slug: ${slug}`);
-    }
-}
-function yamlEscape(value) {
-    if (!value)
-        return value ?? "";
-    if (/[:\-#{}\[\]&*!|>'"%@`]/.test(value) || value.includes("\n")) {
-        return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
-    }
-    return value;
-}
+import { buildSkillMarkdown, validateSlug, writeSkillFiles, } from "@skills-hub-ai/installer";
+import { getSkillDetail, recordInstall, } from "./api.js";
 function getSkillsDir(target) {
     const home = homedir();
     return target === "cursor"
@@ -27,40 +15,53 @@ function getCommandsDir(target) {
         ? join(home, ".cursor", "skills")
         : join(home, ".claude", "commands");
 }
+/**
+ * Build the slash command body for claude-code. The format differs from
+ * SKILL.md: no `---` delimiters, just frontmatter style fields followed
+ * by the body. Kept inline here because it is claude-code specific and
+ * not part of the shared installer API.
+ */
+function buildClaudeCommandContent(skill) {
+    return [
+        `name: ${skill.name}`,
+        `description: ${skill.description}`,
+        `version: ${skill.latestVersion}`,
+        `category: ${skill.category.slug}`,
+        "",
+        skill.instructions,
+        "",
+    ].join("\n");
+}
 /** Install a single skill from the API to the local skills directory */
 export async function installSkill(slug, target = "claude-code") {
     validateSlug(slug);
     const skill = await getSkillDetail(slug);
     const skillDir = join(getSkillsDir(target), slug);
-    mkdirSync(skillDir, { recursive: true });
-    const content = `---
-name: ${yamlEscape(skill.name)}
-description: ${yamlEscape(skill.description)}
-version: ${yamlEscape(skill.latestVersion)}
-category: ${yamlEscape(skill.category.slug)}
----
-
-${skill.instructions}
-`;
-    writeFileSync(join(skillDir, "SKILL.md"), content);
+    const skillMd = buildSkillMarkdown({
+        name: skill.name,
+        description: skill.description,
+        version: skill.latestVersion,
+        category: skill.category.slug,
+    }, skill.instructions);
+    writeSkillFiles(skillDir, [{ relativePath: "SKILL.md", content: skillMd }]);
     // Register as slash command (Claude Code reads from ~/.claude/commands/)
     if (target === "claude-code") {
         const commandsDir = getCommandsDir(target);
-        mkdirSync(commandsDir, { recursive: true });
-        const commandContent = `name: ${yamlEscape(skill.name)}
-description: ${yamlEscape(skill.description)}
-version: ${yamlEscape(skill.latestVersion)}
-category: ${yamlEscape(skill.category.slug)}
-
-${skill.instructions}
-`;
-        writeFileSync(join(commandsDir, `${slug}.md`), commandContent);
+        writeSkillFiles(commandsDir, [
+            {
+                relativePath: `${slug}.md`,
+                content: buildClaudeCommandContent(skill),
+            },
+        ]);
     }
     // Install composition dependencies
     const deps = [];
     if (skill.composition?.children.length) {
         await installDependencies(skill, target, deps);
     }
+    // Record the install so it counts toward installCount and shows up as an MCP
+    // install in analytics. Best-effort — never blocks a successful local write.
+    await recordInstall(slug, target);
     return {
         slug,
         version: skill.latestVersion,
@@ -90,28 +91,24 @@ async function installDependencies(skill, target, installed, visited = new Set()
         try {
             const childDetail = await getSkillDetail(childSlug);
             const childDir = join(skillsDir, childSlug);
-            mkdirSync(childDir, { recursive: true });
-            const content = `---
-name: ${yamlEscape(childDetail.name)}
-description: ${yamlEscape(childDetail.description)}
-version: ${yamlEscape(childDetail.latestVersion)}
-category: ${yamlEscape(childDetail.category.slug)}
----
-
-${childDetail.instructions}
-`;
-            writeFileSync(join(childDir, "SKILL.md"), content);
+            const childSkillMd = buildSkillMarkdown({
+                name: childDetail.name,
+                description: childDetail.description,
+                version: childDetail.latestVersion,
+                category: childDetail.category.slug,
+            }, childDetail.instructions);
+            writeSkillFiles(childDir, [
+                { relativePath: "SKILL.md", content: childSkillMd },
+            ]);
             // Register child as slash command too
             if (target === "claude-code") {
                 const commandsDir = getCommandsDir(target);
-                const commandContent = `name: ${yamlEscape(childDetail.name)}
-description: ${yamlEscape(childDetail.description)}
-version: ${yamlEscape(childDetail.latestVersion)}
-category: ${yamlEscape(childDetail.category.slug)}
-
-${childDetail.instructions}
-`;
-                writeFileSync(join(commandsDir, `${childSlug}.md`), commandContent);
+                writeSkillFiles(commandsDir, [
+                    {
+                        relativePath: `${childSlug}.md`,
+                        content: buildClaudeCommandContent(childDetail),
+                    },
+                ]);
             }
             installed.push(childSlug);
             // Recurse if this child is also a composition

package/dist/installer.js.map

@@ -1 +1 @@
-{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skills-hub-ai/mcp",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "MCP server for skills-hub.ai — serve installed skills as prompts in any MCP-compatible AI tool",
   "license": "MIT",
   "keywords": [
@@ -39,13 +39,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@skills-hub-ai/skill-parser": "0.2.2"
+    "@skills-hub-ai/installer": "0.1.0",
+    "@skills-hub-ai/skill-parser": "0.2.3"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "tsx": "^4.0.0",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.7"
   },
   "scripts": {
     "dev": "tsx src/index.ts",

package/src/api.ts

@@ -2,15 +2,22 @@ const API_URL = process.env.SKILLS_HUB_API_URL || "https://api.skills-hub.ai";
 const API_TOKEN = process.env.SKILLS_HUB_API_TOKEN || "";
 const TIMEOUT_MS = 30_000;
 
-function fetchWithTimeout(url: string): Promise<Response> {
+function fetchWithTimeout(
+  url: string,
+  init: RequestInit = {},
+): Promise<Response> {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
-  const headers: Record<string, string> = {};
+  const headers: Record<string, string> = {
+    // Identifies MCP traffic to the API's analytics (web vs cli vs mcp).
+    "X-Skills-Hub-Client": "mcp",
+    ...((init.headers as Record<string, string>) ?? {}),
+  };
   if (API_TOKEN) {
     headers["Authorization"] = `ApiKey ${API_TOKEN}`;
   }
-  return fetch(url, { signal: controller.signal, headers }).finally(() =>
-    clearTimeout(timer),
+  return fetch(url, { ...init, signal: controller.signal, headers }).finally(
+    () => clearTimeout(timer),
   );
 }
 
@@ -82,3 +89,28 @@ export async function getSkillDetail(slug: string): Promise<SkillDetailResult> {
 
   return (await res.json()) as SkillDetailResult;
 }
+
+/**
+ * Record a completed install so it counts toward the skill's installCount and
+ * shows up as an MCP install in analytics. Best-effort: a tracking failure must
+ * never break an install that already wrote files locally, so this swallows all
+ * errors. Anonymous (no API token) installs are deduped server-side by IP.
+ */
+export async function recordInstall(
+  slug: string,
+  target: "claude-code" | "cursor",
+): Promise<void> {
+  const platform = target === "cursor" ? "CURSOR" : "CLAUDE_CODE";
+  try {
+    await fetchWithTimeout(
+      `${API_URL}/api/v1/skills/${encodeURIComponent(slug)}/install`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ platform }),
+      },
+    );
+  } catch {
+    // Swallow — install already succeeded locally; tracking is best-effort.
+  }
+}

package/src/installer.test.ts

@@ -10,11 +10,13 @@ vi.mock("node:fs", () => ({
 
 vi.mock("./api.js", () => ({
   getSkillDetail: vi.fn(),
+  recordInstall: vi.fn(),
 }));
 
-import { getSkillDetail } from "./api.js";
+import { getSkillDetail, recordInstall } from "./api.js";
 
 const mockGetSkillDetail = vi.mocked(getSkillDetail);
+const mockRecordInstall = vi.mocked(recordInstall);
 const mockExistsSync = vi.mocked(existsSync);
 const mockMkdirSync = vi.mocked(mkdirSync);
 const mockWriteFileSync = vi.mocked(writeFileSync);
@@ -57,6 +59,11 @@ describe("installSkill", () => {
     expect(result.slug).toBe("review-code");
     expect(result.version).toBe("1.2.0");
     expect(result.dependencies).toEqual([]);
+    // Records the install so it counts toward installCount + MCP analytics.
+    expect(mockRecordInstall).toHaveBeenCalledWith(
+      "review-code",
+      "claude-code",
+    );
   });
 
   it("writes SKILL.md and command file", async () => {

package/src/installer.ts

@@ -1,21 +1,16 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
-import { getSkillDetail, type SkillDetailResult } from "./api.js";
-
-function validateSlug(slug: string): void {
-  if (!slug || /[/\\]|\.\./.test(slug)) {
-    throw new Error(`Invalid slug: ${slug}`);
-  }
-}
-
-function yamlEscape(value: string): string {
-  if (!value) return value ?? "";
-  if (/[:\-#{}\[\]&*!|>'"%@`]/.test(value) || value.includes("\n")) {
-    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
-  }
-  return value;
-}
+import {
+  buildSkillMarkdown,
+  validateSlug,
+  writeSkillFiles,
+} from "@skills-hub-ai/installer";
+import {
+  getSkillDetail,
+  recordInstall,
+  type SkillDetailResult,
+} from "./api.js";
 
 function getSkillsDir(target: "claude-code" | "cursor"): string {
   const home = homedir();
@@ -31,6 +26,30 @@ function getCommandsDir(target: "claude-code" | "cursor"): string {
     : join(home, ".claude", "commands");
 }
 
+/**
+ * Build the slash command body for claude-code. The format differs from
+ * SKILL.md: no `---` delimiters, just frontmatter style fields followed
+ * by the body. Kept inline here because it is claude-code specific and
+ * not part of the shared installer API.
+ */
+function buildClaudeCommandContent(skill: {
+  name: string;
+  description: string;
+  latestVersion: string;
+  category: { slug: string };
+  instructions: string;
+}): string {
+  return [
+    `name: ${skill.name}`,
+    `description: ${skill.description}`,
+    `version: ${skill.latestVersion}`,
+    `category: ${skill.category.slug}`,
+    "",
+    skill.instructions,
+    "",
+  ].join("\n");
+}
+
 export interface InstallResult {
   slug: string;
   version: string;
@@ -47,32 +66,27 @@ export async function installSkill(
   const skill = await getSkillDetail(slug);
   const skillDir = join(getSkillsDir(target), slug);
 
-  mkdirSync(skillDir, { recursive: true });
-
-  const content = `---
-name: ${yamlEscape(skill.name)}
-description: ${yamlEscape(skill.description)}
-version: ${yamlEscape(skill.latestVersion)}
-category: ${yamlEscape(skill.category.slug)}
----
+  const skillMd = buildSkillMarkdown(
+    {
+      name: skill.name,
+      description: skill.description,
+      version: skill.latestVersion,
+      category: skill.category.slug,
+    },
+    skill.instructions,
+  );
 
-${skill.instructions}
-`;
-
-  writeFileSync(join(skillDir, "SKILL.md"), content);
+  writeSkillFiles(skillDir, [{ relativePath: "SKILL.md", content: skillMd }]);
 
   // Register as slash command (Claude Code reads from ~/.claude/commands/)
   if (target === "claude-code") {
     const commandsDir = getCommandsDir(target);
-    mkdirSync(commandsDir, { recursive: true });
-    const commandContent = `name: ${yamlEscape(skill.name)}
-description: ${yamlEscape(skill.description)}
-version: ${yamlEscape(skill.latestVersion)}
-category: ${yamlEscape(skill.category.slug)}
-
-${skill.instructions}
-`;
-    writeFileSync(join(commandsDir, `${slug}.md`), commandContent);
+    writeSkillFiles(commandsDir, [
+      {
+        relativePath: `${slug}.md`,
+        content: buildClaudeCommandContent(skill),
+      },
+    ]);
   }
 
   // Install composition dependencies
@@ -81,6 +95,10 @@ ${skill.instructions}
     await installDependencies(skill, target, deps);
   }
 
+  // Record the install so it counts toward installCount and shows up as an MCP
+  // install in analytics. Best-effort — never blocks a successful local write.
+  await recordInstall(slug, target);
+
   return {
     slug,
     version: skill.latestVersion,
@@ -118,30 +136,30 @@ async function installDependencies(
     try {
       const childDetail = await getSkillDetail(childSlug);
       const childDir = join(skillsDir, childSlug);
-      mkdirSync(childDir, { recursive: true });
 
-      const content = `---
-name: ${yamlEscape(childDetail.name)}
-description: ${yamlEscape(childDetail.description)}
-version: ${yamlEscape(childDetail.latestVersion)}
-category: ${yamlEscape(childDetail.category.slug)}
----
+      const childSkillMd = buildSkillMarkdown(
+        {
+          name: childDetail.name,
+          description: childDetail.description,
+          version: childDetail.latestVersion,
+          category: childDetail.category.slug,
+        },
+        childDetail.instructions,
+      );
 
-${childDetail.instructions}
-`;
-      writeFileSync(join(childDir, "SKILL.md"), content);
+      writeSkillFiles(childDir, [
+        { relativePath: "SKILL.md", content: childSkillMd },
+      ]);
 
       // Register child as slash command too
       if (target === "claude-code") {
         const commandsDir = getCommandsDir(target);
-        const commandContent = `name: ${yamlEscape(childDetail.name)}
-description: ${yamlEscape(childDetail.description)}
-version: ${yamlEscape(childDetail.latestVersion)}
-category: ${yamlEscape(childDetail.category.slug)}
-
-${childDetail.instructions}
-`;
-        writeFileSync(join(commandsDir, `${childSlug}.md`), commandContent);
+        writeSkillFiles(commandsDir, [
+          {
+            relativePath: `${childSlug}.md`,
+            content: buildClaudeCommandContent(childDetail),
+          },
+        ]);
       }
 
       installed.push(childSlug);