@skills-hub-ai/mcp 0.1.9 → 0.1.11
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 +17 -0
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +28 -2
- package/dist/api.js.map +1 -1
- package/dist/installer.d.ts.map +1 -1
- package/dist/installer.js +38 -18
- package/dist/installer.js.map +1 -1
- package/package.json +6 -5
- package/src/api.ts +49 -2
- package/src/installer.test.ts +12 -1
- package/src/installer.ts +62 -25
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":"
|
|
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":"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,CACvB,GAAW,EACX,OAAoB,EAAE;IAEtB,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;QACtC,
|
|
1
|
+
{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
|
package/dist/installer.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"
|
|
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/skill-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
|
-
|
|
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
|
-
|
|
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);
|
package/dist/installer.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,
|
|
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.
|
|
3
|
+
"version": "0.1.11",
|
|
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",
|
|
@@ -39,14 +40,14 @@
|
|
|
39
40
|
},
|
|
40
41
|
"dependencies": {
|
|
41
42
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
42
|
-
"@skills-hub-ai/installer": "0.1.0",
|
|
43
|
-
"@skills-hub-ai/skill-parser": "0.2.
|
|
43
|
+
"@skills-hub-ai/skill-installer": "0.1.0",
|
|
44
|
+
"@skills-hub-ai/skill-parser": "0.2.4"
|
|
44
45
|
},
|
|
45
46
|
"devDependencies": {
|
|
46
47
|
"@types/node": "^25.6.0",
|
|
47
|
-
"tsx": "^4.
|
|
48
|
+
"tsx": "^4.23.0",
|
|
48
49
|
"typescript": "^6.0.3",
|
|
49
|
-
"vitest": "^4.1.
|
|
50
|
+
"vitest": "^4.1.10"
|
|
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
|
package/src/installer.test.ts
CHANGED
|
@@ -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 {
|
|
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,
|
|
8
|
-
|
|
10
|
+
type SkillFileEntry,
|
|
11
|
+
} from "@skills-hub-ai/skill-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
|
-
|
|
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
|
-
|
|
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") {
|