@skills-hub-ai/mcp 0.1.9 → 0.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/api.d.ts CHANGED
@@ -43,6 +43,23 @@ export interface SkillDetailResult {
43
43
  }
44
44
  export declare function searchSkills(query: string, category?: string, limit?: number, org?: string): Promise<SkillSearchResult[]>;
45
45
  export declare function getSkillDetail(slug: string): Promise<SkillDetailResult>;
46
+ export interface SkillFileManifestEntry {
47
+ relativePath: string;
48
+ bytes: number;
49
+ lines: number;
50
+ sha256: string;
51
+ }
52
+ /**
53
+ * Fetch the full file manifest for a skill version. Returns null when the
54
+ * version has no file tree (skills synced before multi-file ingest). Callers
55
+ * should fall back to the `instructions` field in that case.
56
+ */
57
+ export declare function fetchSkillFileManifest(slug: string, version: string): Promise<SkillFileManifestEntry[] | null>;
58
+ /**
59
+ * Fetch the content of a single file from a skill version. The relativePath
60
+ * must match exactly what the manifest returned.
61
+ */
62
+ export declare function fetchSkillFile(slug: string, version: string, relativePath: string): Promise<string>;
46
63
  /**
47
64
  * Record a completed install so it counts toward the skill's installCount and
48
65
  * shows up as an MCP install in analytics. Best-effort: a tracking failure must
package/dist/api.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"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"}
1
+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAqBA,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,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,EAAE,GAAG,IAAI,CAAC,CAU1C;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;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 CHANGED
@@ -5,8 +5,6 @@ function fetchWithTimeout(url, init = {}) {
5
5
  const controller = new AbortController();
6
6
  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
7
7
  const headers = {
8
- // Identifies MCP traffic to the API's analytics (web vs cli vs mcp).
9
- "X-Skills-Hub-Client": "mcp",
10
8
  ...(init.headers ?? {}),
11
9
  };
12
10
  if (API_TOKEN) {
@@ -38,6 +36,34 @@ export async function getSkillDetail(slug) {
38
36
  }
39
37
  return (await res.json());
40
38
  }
39
+ /**
40
+ * Fetch the full file manifest for a skill version. Returns null when the
41
+ * version has no file tree (skills synced before multi-file ingest). Callers
42
+ * should fall back to the `instructions` field in that case.
43
+ */
44
+ export async function fetchSkillFileManifest(slug, version) {
45
+ const res = await fetchWithTimeout(`${API_URL}/api/v1/skills/${encodeURIComponent(slug)}/versions/${encodeURIComponent(version)}/files`);
46
+ if (res.status === 404)
47
+ return null;
48
+ if (!res.ok) {
49
+ throw new Error(`Manifest fetch failed: ${res.status} ${res.statusText}`);
50
+ }
51
+ const data = (await res.json());
52
+ return data.files;
53
+ }
54
+ /**
55
+ * Fetch the content of a single file from a skill version. The relativePath
56
+ * must match exactly what the manifest returned.
57
+ */
58
+ export async function fetchSkillFile(slug, version, relativePath) {
59
+ const encoded = relativePath.split("/").map(encodeURIComponent).join("/");
60
+ const res = await fetchWithTimeout(`${API_URL}/api/v1/skills/${encodeURIComponent(slug)}/versions/${encodeURIComponent(version)}/files/${encoded}`);
61
+ if (!res.ok) {
62
+ throw new Error(`File fetch failed: ${relativePath} (${res.status} ${res.statusText})`);
63
+ }
64
+ const data = (await res.json());
65
+ return data.content;
66
+ }
41
67
  /**
42
68
  * Record a completed install so it counts toward the skill's installCount and
43
69
  * shows up as an MCP install in analytics. Best-effort: a tracking failure must
package/dist/api.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"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"}
1
+ {"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AA2DA,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;AAsDD,wEAAwE;AACxE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,aAAa,GAAG,QAAwB,GAC/C,OAAO,CAAC,aAAa,CAAC,CAkCxB"}
package/dist/installer.js CHANGED
@@ -1,8 +1,9 @@
1
1
  import { existsSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { homedir } from "node:os";
4
- import { buildSkillMarkdown, validateSlug, writeSkillFiles, } from "@skills-hub-ai/installer";
5
- import { getSkillDetail, recordInstall, } from "./api.js";
4
+ import { atomicWriteSkillFiles, buildSkillMarkdown, readLocalFile, validateSlug, writeSkillFiles, } from "@skills-hub-ai/installer";
5
+ import { fetchSkillFile, fetchSkillFileManifest, getSkillDetail, recordInstall, } from "./api.js";
6
+ const LEARNINGS_PATTERN = /^LEARNINGS(\.md)?$/i;
6
7
  function getSkillsDir(target) {
7
8
  const home = homedir();
8
9
  return target === "cursor"
@@ -32,18 +33,45 @@ function buildClaudeCommandContent(skill) {
32
33
  "",
33
34
  ].join("\n");
34
35
  }
36
+ /**
37
+ * Write a skill's file tree to `skillDir`.
38
+ *
39
+ * Prefers the multi-file manifest when available (fetches every file and
40
+ * writes atomically). Falls back to a single generated SKILL.md for older
41
+ * skills that pre-date multi-file ingest. Preserves any existing LEARNINGS.md
42
+ * in both paths — it is user state, not part of the published skill.
43
+ */
44
+ async function writeSkillTree(skill, skillDir) {
45
+ const manifest = await fetchSkillFileManifest(skill.slug, skill.latestVersion);
46
+ if (manifest && manifest.length > 0) {
47
+ const learnings = readLocalFile(skillDir, "LEARNINGS.md");
48
+ const files = await Promise.all(manifest
49
+ .filter((entry) => !LEARNINGS_PATTERN.test(entry.relativePath))
50
+ .map(async (entry) => ({
51
+ relativePath: entry.relativePath,
52
+ content: await fetchSkillFile(skill.slug, skill.latestVersion, entry.relativePath),
53
+ })));
54
+ if (learnings !== null) {
55
+ files.push({ relativePath: "LEARNINGS.md", content: learnings });
56
+ }
57
+ atomicWriteSkillFiles(skillDir, files);
58
+ }
59
+ else {
60
+ const skillMd = buildSkillMarkdown({
61
+ name: skill.name,
62
+ description: skill.description,
63
+ version: skill.latestVersion,
64
+ category: skill.category.slug,
65
+ }, skill.instructions);
66
+ writeSkillFiles(skillDir, [{ relativePath: "SKILL.md", content: skillMd }]);
67
+ }
68
+ }
35
69
  /** Install a single skill from the API to the local skills directory */
36
70
  export async function installSkill(slug, target = "claude-code") {
37
71
  validateSlug(slug);
38
72
  const skill = await getSkillDetail(slug);
39
73
  const skillDir = join(getSkillsDir(target), slug);
40
- const skillMd = buildSkillMarkdown({
41
- name: skill.name,
42
- description: skill.description,
43
- version: skill.latestVersion,
44
- category: skill.category.slug,
45
- }, skill.instructions);
46
- writeSkillFiles(skillDir, [{ relativePath: "SKILL.md", content: skillMd }]);
74
+ await writeSkillTree(skill, skillDir);
47
75
  // Register as slash command (Claude Code reads from ~/.claude/commands/)
48
76
  if (target === "claude-code") {
49
77
  const commandsDir = getCommandsDir(target);
@@ -91,15 +119,7 @@ async function installDependencies(skill, target, installed, visited = new Set()
91
119
  try {
92
120
  const childDetail = await getSkillDetail(childSlug);
93
121
  const childDir = join(skillsDir, childSlug);
94
- const childSkillMd = buildSkillMarkdown({
95
- name: childDetail.name,
96
- description: childDetail.description,
97
- version: childDetail.latestVersion,
98
- category: childDetail.category.slug,
99
- }, childDetail.instructions);
100
- writeSkillFiles(childDir, [
101
- { relativePath: "SKILL.md", content: childSkillMd },
102
- ]);
122
+ await writeSkillTree(childDetail, childDir);
103
123
  // Register child as slash command too
104
124
  if (target === "claude-code") {
105
125
  const commandsDir = getCommandsDir(target);
@@ -1 +1 @@
1
- {"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "name": "@skills-hub-ai/mcp",
3
- "version": "0.1.9",
3
+ "version": "0.1.10",
4
4
  "description": "MCP server for skills-hub.ai — serve installed skills as prompts in any MCP-compatible AI tool",
5
5
  "license": "MIT",
6
+ "mcpName": "io.github.tinh2/skills-hub",
6
7
  "keywords": [
7
8
  "mcp",
8
9
  "model-context-protocol",
@@ -46,7 +47,7 @@
46
47
  "@types/node": "^25.6.0",
47
48
  "tsx": "^4.22.4",
48
49
  "typescript": "^6.0.3",
49
- "vitest": "^4.1.7"
50
+ "vitest": "^4.1.8"
50
51
  },
51
52
  "scripts": {
52
53
  "dev": "tsx src/index.ts",
package/src/api.ts CHANGED
@@ -9,8 +9,6 @@ function fetchWithTimeout(
9
9
  const controller = new AbortController();
10
10
  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
11
11
  const headers: Record<string, string> = {
12
- // Identifies MCP traffic to the API's analytics (web vs cli vs mcp).
13
- "X-Skills-Hub-Client": "mcp",
14
12
  ...((init.headers as Record<string, string>) ?? {}),
15
13
  };
16
14
  if (API_TOKEN) {
@@ -90,6 +88,55 @@ export async function getSkillDetail(slug: string): Promise<SkillDetailResult> {
90
88
  return (await res.json()) as SkillDetailResult;
91
89
  }
92
90
 
91
+ export interface SkillFileManifestEntry {
92
+ relativePath: string;
93
+ bytes: number;
94
+ lines: number;
95
+ sha256: string;
96
+ }
97
+
98
+ /**
99
+ * Fetch the full file manifest for a skill version. Returns null when the
100
+ * version has no file tree (skills synced before multi-file ingest). Callers
101
+ * should fall back to the `instructions` field in that case.
102
+ */
103
+ export async function fetchSkillFileManifest(
104
+ slug: string,
105
+ version: string,
106
+ ): Promise<SkillFileManifestEntry[] | null> {
107
+ const res = await fetchWithTimeout(
108
+ `${API_URL}/api/v1/skills/${encodeURIComponent(slug)}/versions/${encodeURIComponent(version)}/files`,
109
+ );
110
+ if (res.status === 404) return null;
111
+ if (!res.ok) {
112
+ throw new Error(`Manifest fetch failed: ${res.status} ${res.statusText}`);
113
+ }
114
+ const data = (await res.json()) as { files: SkillFileManifestEntry[] };
115
+ return data.files;
116
+ }
117
+
118
+ /**
119
+ * Fetch the content of a single file from a skill version. The relativePath
120
+ * must match exactly what the manifest returned.
121
+ */
122
+ export async function fetchSkillFile(
123
+ slug: string,
124
+ version: string,
125
+ relativePath: string,
126
+ ): Promise<string> {
127
+ const encoded = relativePath.split("/").map(encodeURIComponent).join("/");
128
+ const res = await fetchWithTimeout(
129
+ `${API_URL}/api/v1/skills/${encodeURIComponent(slug)}/versions/${encodeURIComponent(version)}/files/${encoded}`,
130
+ );
131
+ if (!res.ok) {
132
+ throw new Error(
133
+ `File fetch failed: ${relativePath} (${res.status} ${res.statusText})`,
134
+ );
135
+ }
136
+ const data = (await res.json()) as { content: string };
137
+ return data.content;
138
+ }
139
+
93
140
  /**
94
141
  * Record a completed install so it counts toward the skill's installCount and
95
142
  * shows up as an MCP install in analytics. Best-effort: a tracking failure must
@@ -11,12 +11,21 @@ vi.mock("node:fs", () => ({
11
11
  vi.mock("./api.js", () => ({
12
12
  getSkillDetail: vi.fn(),
13
13
  recordInstall: vi.fn(),
14
+ fetchSkillFileManifest: vi.fn(),
15
+ fetchSkillFile: vi.fn(),
14
16
  }));
15
17
 
16
- import { getSkillDetail, recordInstall } from "./api.js";
18
+ import {
19
+ getSkillDetail,
20
+ recordInstall,
21
+ fetchSkillFileManifest,
22
+ fetchSkillFile,
23
+ } from "./api.js";
17
24
 
18
25
  const mockGetSkillDetail = vi.mocked(getSkillDetail);
19
26
  const mockRecordInstall = vi.mocked(recordInstall);
27
+ const mockFetchSkillFileManifest = vi.mocked(fetchSkillFileManifest);
28
+ vi.mocked(fetchSkillFile);
20
29
  const mockExistsSync = vi.mocked(existsSync);
21
30
  const mockMkdirSync = vi.mocked(mkdirSync);
22
31
  const mockWriteFileSync = vi.mocked(writeFileSync);
@@ -40,6 +49,8 @@ const baseSkill = {
40
49
  beforeEach(() => {
41
50
  vi.clearAllMocks();
42
51
  mockExistsSync.mockReturnValue(false);
52
+ // Default: no multi-file manifest, fall back to single SKILL.md path
53
+ mockFetchSkillFileManifest.mockResolvedValue(null);
43
54
  });
44
55
 
45
56
  describe("installSkill", () => {
package/src/installer.ts CHANGED
@@ -2,16 +2,23 @@ import { existsSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { homedir } from "node:os";
4
4
  import {
5
+ atomicWriteSkillFiles,
5
6
  buildSkillMarkdown,
7
+ readLocalFile,
6
8
  validateSlug,
7
9
  writeSkillFiles,
10
+ type SkillFileEntry,
8
11
  } from "@skills-hub-ai/installer";
9
12
  import {
13
+ fetchSkillFile,
14
+ fetchSkillFileManifest,
10
15
  getSkillDetail,
11
16
  recordInstall,
12
17
  type SkillDetailResult,
13
18
  } from "./api.js";
14
19
 
20
+ const LEARNINGS_PATTERN = /^LEARNINGS(\.md)?$/i;
21
+
15
22
  function getSkillsDir(target: "claude-code" | "cursor"): string {
16
23
  const home = homedir();
17
24
  return target === "cursor"
@@ -57,6 +64,58 @@ export interface InstallResult {
57
64
  dependencies: string[];
58
65
  }
59
66
 
67
+ /**
68
+ * Write a skill's file tree to `skillDir`.
69
+ *
70
+ * Prefers the multi-file manifest when available (fetches every file and
71
+ * writes atomically). Falls back to a single generated SKILL.md for older
72
+ * skills that pre-date multi-file ingest. Preserves any existing LEARNINGS.md
73
+ * in both paths — it is user state, not part of the published skill.
74
+ */
75
+ async function writeSkillTree(
76
+ skill: SkillDetailResult,
77
+ skillDir: string,
78
+ ): Promise<void> {
79
+ const manifest = await fetchSkillFileManifest(
80
+ skill.slug,
81
+ skill.latestVersion,
82
+ );
83
+
84
+ if (manifest && manifest.length > 0) {
85
+ const learnings = readLocalFile(skillDir, "LEARNINGS.md");
86
+
87
+ const files: SkillFileEntry[] = await Promise.all(
88
+ manifest
89
+ .filter((entry) => !LEARNINGS_PATTERN.test(entry.relativePath))
90
+ .map(async (entry) => ({
91
+ relativePath: entry.relativePath,
92
+ content: await fetchSkillFile(
93
+ skill.slug,
94
+ skill.latestVersion,
95
+ entry.relativePath,
96
+ ),
97
+ })),
98
+ );
99
+
100
+ if (learnings !== null) {
101
+ files.push({ relativePath: "LEARNINGS.md", content: learnings });
102
+ }
103
+
104
+ atomicWriteSkillFiles(skillDir, files);
105
+ } else {
106
+ const skillMd = buildSkillMarkdown(
107
+ {
108
+ name: skill.name,
109
+ description: skill.description,
110
+ version: skill.latestVersion,
111
+ category: skill.category.slug,
112
+ },
113
+ skill.instructions,
114
+ );
115
+ writeSkillFiles(skillDir, [{ relativePath: "SKILL.md", content: skillMd }]);
116
+ }
117
+ }
118
+
60
119
  /** Install a single skill from the API to the local skills directory */
61
120
  export async function installSkill(
62
121
  slug: string,
@@ -66,17 +125,7 @@ export async function installSkill(
66
125
  const skill = await getSkillDetail(slug);
67
126
  const skillDir = join(getSkillsDir(target), slug);
68
127
 
69
- const skillMd = buildSkillMarkdown(
70
- {
71
- name: skill.name,
72
- description: skill.description,
73
- version: skill.latestVersion,
74
- category: skill.category.slug,
75
- },
76
- skill.instructions,
77
- );
78
-
79
- writeSkillFiles(skillDir, [{ relativePath: "SKILL.md", content: skillMd }]);
128
+ await writeSkillTree(skill, skillDir);
80
129
 
81
130
  // Register as slash command (Claude Code reads from ~/.claude/commands/)
82
131
  if (target === "claude-code") {
@@ -137,19 +186,7 @@ async function installDependencies(
137
186
  const childDetail = await getSkillDetail(childSlug);
138
187
  const childDir = join(skillsDir, childSlug);
139
188
 
140
- const childSkillMd = buildSkillMarkdown(
141
- {
142
- name: childDetail.name,
143
- description: childDetail.description,
144
- version: childDetail.latestVersion,
145
- category: childDetail.category.slug,
146
- },
147
- childDetail.instructions,
148
- );
149
-
150
- writeSkillFiles(childDir, [
151
- { relativePath: "SKILL.md", content: childSkillMd },
152
- ]);
189
+ await writeSkillTree(childDetail, childDir);
153
190
 
154
191
  // Register child as slash command too
155
192
  if (target === "claude-code") {