@mcp-s/skills 1.0.5 → 1.3.1

package/package.json

@@ -1,53 +1,111 @@
 {
   "name": "@mcp-s/skills",
-  "version": "1.0.5",
-  "description": "Install skills onto coding agents from MCP-S server",
+  "version": "1.3.1",
+  "description": "The open agent skills ecosystem",
   "type": "module",
-  "files": [
-    "dist"
-  ],
-  "main": "dist/index.js",
   "bin": {
-    "skills": "dist/index.js"
+    "skills": "./bin/cli.mjs",
+    "add-skill": "./bin/cli.mjs"
   },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "ThirdPartyNoticeText.txt"
+  ],
   "scripts": {
-    "start": "node dist/index.js",
-    "build": "tsc && shx chmod +x dist/*.js",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build && npm version patch",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "node scripts/generate-licenses.ts && obuild",
+    "generate-licenses": "node scripts/generate-licenses.ts",
+    "dev": "node src/cli.ts",
+    "exec:test": "node scripts/execute-tests.ts",
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write 'src/**/*.ts' 'scripts/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'scripts/**/*.ts'",
+    "prepare": "husky",
+    "test": "vitest",
+    "type-check": "tsc --noEmit",
+    "publish:snapshot": "npm version prerelease --preid=snapshot --no-git-tag-version && npm publish --tag snapshot"
+  },
+  "lint-staged": {
+    "src/**/*.ts": "prettier --write",
+    "scripts/**/*.ts": "prettier --write",
+    "tests/**/*.ts": "prettier --write"
   },
-  "author": "MCP-S",
-  "license": "ISC",
   "keywords": [
     "cli",
     "agent-skills",
     "skills",
     "ai-agents",
-    "mcp-s",
+    "amp",
+    "antigravity",
+    "augment",
     "claude-code",
+    "openclaw",
     "cline",
+    "codebuddy",
     "codex",
+    "command-code",
+    "continue",
+    "crush",
     "cursor",
+    "droid",
+    "gemini-cli",
+    "github-copilot",
+    "goose",
+    "junie",
+    "iflow-cli",
+    "kilo",
+    "kimi-cli",
+    "kiro-cli",
+    "kode",
+    "mcpjam",
+    "mistral-vibe",
+    "mux",
     "opencode",
+    "openclaude",
     "openhands",
-    "windsurf"
+    "pi",
+    "qoder",
+    "qwen-code",
+    "replit",
+    "roo",
+    "trae",
+    "trae-cn",
+    "windsurf",
+    "zencoder",
+    "neovate",
+    "pochi",
+    "adal"
   ],
-  "dependencies": {
-    "@clack/prompts": "^0.9.1",
-    "chalk": "^5.4.1",
-    "commander": "^13.1.0",
-    "open": "^10.1.1"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vercel-labs/skills.git"
   },
-  "publishConfig": {
-    "access": "public"
+  "homepage": "https://github.com/vercel-labs/skills#readme",
+  "bugs": {
+    "url": "https://github.com/vercel-labs/skills/issues"
   },
+  "author": "",
+  "license": "MIT",
   "devDependencies": {
-    "@types/node": "^22.14.0",
-    "shx": "^0.4.0",
-    "typescript": "^5.8.3"
+    "@clack/prompts": "^0.11.0",
+    "@types/bun": "latest",
+    "@types/node": "^22.10.0",
+    "@types/unzipper": "^0.10.11",
+    "gray-matter": "^4.0.3",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "obuild": "^0.4.22",
+    "picocolors": "^1.1.1",
+    "prettier": "^3.8.1",
+    "simple-git": "^3.27.0",
+    "typescript": "^5.9.3",
+    "unzipper": "^0.12.3",
+    "vitest": "^4.0.17",
+    "xdg-basedir": "^5.1.0"
   },
   "engines": {
     "node": ">=18"
-  }
+  },
+  "packageManager": "pnpm@10.17.1"
 }

package/dist/agents.js

@@ -1,246 +0,0 @@
-import { homedir } from "os";
-import { join } from "path";
-import { existsSync } from "fs";
-const home = homedir();
-export const agents = {
-    amp: {
-        name: "amp",
-        displayName: "Amp",
-        skillsDir: ".agents/skills",
-        globalSkillsDir: join(home, ".config/agents/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".config/amp"));
-        },
-    },
-    antigravity: {
-        name: "antigravity",
-        displayName: "Antigravity",
-        skillsDir: ".agent/skills",
-        globalSkillsDir: join(home, ".gemini/antigravity/skills"),
-        detectInstalled: async () => {
-            return (existsSync(join(process.cwd(), ".agent")) ||
-                existsSync(join(home, ".gemini/antigravity")));
-        },
-    },
-    "claude-code": {
-        name: "claude-code",
-        displayName: "Claude Code",
-        skillsDir: ".claude/skills",
-        globalSkillsDir: join(home, ".claude/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".claude"));
-        },
-    },
-    clawdbot: {
-        name: "clawdbot",
-        displayName: "Clawdbot",
-        skillsDir: "skills",
-        globalSkillsDir: join(home, ".clawdbot/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".clawdbot"));
-        },
-    },
-    cline: {
-        name: "cline",
-        displayName: "Cline",
-        skillsDir: ".cline/skills",
-        globalSkillsDir: join(home, ".cline/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".cline"));
-        },
-    },
-    codex: {
-        name: "codex",
-        displayName: "Codex",
-        skillsDir: ".codex/skills",
-        globalSkillsDir: join(home, ".codex/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".codex"));
-        },
-    },
-    "command-code": {
-        name: "command-code",
-        displayName: "Command Code",
-        skillsDir: ".commandcode/skills",
-        globalSkillsDir: join(home, ".commandcode/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".commandcode"));
-        },
-    },
-    cursor: {
-        name: "cursor",
-        displayName: "Cursor",
-        skillsDir: ".cursor/skills",
-        globalSkillsDir: join(home, ".cursor/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".cursor"));
-        },
-    },
-    droid: {
-        name: "droid",
-        displayName: "Droid",
-        skillsDir: ".factory/skills",
-        globalSkillsDir: join(home, ".factory/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".factory/skills"));
-        },
-    },
-    "gemini-cli": {
-        name: "gemini-cli",
-        displayName: "Gemini CLI",
-        skillsDir: ".gemini/skills",
-        globalSkillsDir: join(home, ".gemini/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".gemini"));
-        },
-    },
-    "github-copilot": {
-        name: "github-copilot",
-        displayName: "GitHub Copilot",
-        skillsDir: ".github/skills",
-        globalSkillsDir: join(home, ".copilot/skills"),
-        detectInstalled: async () => {
-            return (existsSync(join(process.cwd(), ".github")) ||
-                existsSync(join(home, ".copilot")));
-        },
-    },
-    goose: {
-        name: "goose",
-        displayName: "Goose",
-        skillsDir: ".goose/skills",
-        globalSkillsDir: join(home, ".config/goose/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".config/goose"));
-        },
-    },
-    kilo: {
-        name: "kilo",
-        displayName: "Kilo Code",
-        skillsDir: ".kilocode/skills",
-        globalSkillsDir: join(home, ".kilocode/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".kilocode"));
-        },
-    },
-    "kiro-cli": {
-        name: "kiro-cli",
-        displayName: "Kiro CLI",
-        skillsDir: ".kiro/skills",
-        globalSkillsDir: join(home, ".kiro/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".kiro"));
-        },
-    },
-    mcpjam: {
-        name: "mcpjam",
-        displayName: "MCPJam",
-        skillsDir: ".mcpjam/skills",
-        globalSkillsDir: join(home, ".mcpjam/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".mcpjam"));
-        },
-    },
-    opencode: {
-        name: "opencode",
-        displayName: "OpenCode",
-        skillsDir: ".opencode/skills",
-        globalSkillsDir: join(home, ".config/opencode/skills"),
-        detectInstalled: async () => {
-            return (existsSync(join(home, ".config/opencode")) ||
-                existsSync(join(home, ".claude/skills")));
-        },
-    },
-    openhands: {
-        name: "openhands",
-        displayName: "OpenHands",
-        skillsDir: ".openhands/skills",
-        globalSkillsDir: join(home, ".openhands/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".openhands"));
-        },
-    },
-    pi: {
-        name: "pi",
-        displayName: "Pi",
-        skillsDir: ".pi/skills",
-        globalSkillsDir: join(home, ".pi/agent/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".pi/agent"));
-        },
-    },
-    qoder: {
-        name: "qoder",
-        displayName: "Qoder",
-        skillsDir: ".qoder/skills",
-        globalSkillsDir: join(home, ".qoder/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".qoder"));
-        },
-    },
-    "qwen-code": {
-        name: "qwen-code",
-        displayName: "Qwen Code",
-        skillsDir: ".qwen/skills",
-        globalSkillsDir: join(home, ".qwen/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".qwen"));
-        },
-    },
-    roo: {
-        name: "roo",
-        displayName: "Roo Code",
-        skillsDir: ".roo/skills",
-        globalSkillsDir: join(home, ".roo/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".roo"));
-        },
-    },
-    trae: {
-        name: "trae",
-        displayName: "Trae",
-        skillsDir: ".trae/skills",
-        globalSkillsDir: join(home, ".trae/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".trae"));
-        },
-    },
-    windsurf: {
-        name: "windsurf",
-        displayName: "Windsurf",
-        skillsDir: ".windsurf/skills",
-        globalSkillsDir: join(home, ".codeium/windsurf/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".codeium/windsurf"));
-        },
-    },
-    zencoder: {
-        name: "zencoder",
-        displayName: "Zencoder",
-        skillsDir: ".zencoder/skills",
-        globalSkillsDir: join(home, ".zencoder/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".zencoder"));
-        },
-    },
-    neovate: {
-        name: "neovate",
-        displayName: "Neovate",
-        skillsDir: ".neovate/skills",
-        globalSkillsDir: join(home, ".neovate/skills"),
-        detectInstalled: async () => {
-            return existsSync(join(home, ".neovate"));
-        },
-    },
-};
-export async function detectInstalledAgents() {
-    const installed = [];
-    for (const [type, config] of Object.entries(agents)) {
-        if (await config.detectInstalled()) {
-            installed.push(type);
-        }
-    }
-    return installed;
-}
-export function getAgentConfig(type) {
-    return agents[type];
-}

package/dist/api.js

@@ -1,98 +0,0 @@
-export async function fetchSkills(baseUrl, auth) {
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (auth) {
-        headers["Authorization"] = `${auth.userAccessKey}:${auth.userOTT}`;
-    }
-    const response = await fetch(`${baseUrl}/skills`, {
-        headers,
-    });
-    if (!response.ok) {
-        const errorText = await response.text();
-        // Check for authentication error
-        if (response.status === 401) {
-            const error = new Error("Unauthorized");
-            error.status = 401;
-            throw error;
-        }
-        throw new Error(`Failed to fetch skills: ${response.status} ${response.statusText}\n${errorText}`);
-    }
-    const data = await response.json();
-    return data.data;
-}
-export async function fetchSkillContent(baseUrl, skillSlug, auth) {
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (auth) {
-        headers["Authorization"] = `${auth.userAccessKey}:${auth.userOTT}`;
-    }
-    const response = await fetch(`${baseUrl}/skills/${skillSlug}/content`, {
-        headers,
-    });
-    if (!response.ok) {
-        const errorText = await response.text();
-        if (response.status === 401) {
-            const error = new Error("Unauthorized");
-            error.status = 401;
-            throw error;
-        }
-        throw new Error(`Failed to fetch skill content: ${response.status} ${response.statusText}\n${errorText}`);
-    }
-    const data = await response.json();
-    return data.content;
-}
-export async function fetchSkillFiles(baseUrl, skillSlug, auth) {
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (auth) {
-        headers["Authorization"] = `${auth.userAccessKey}:${auth.userOTT}`;
-    }
-    const response = await fetch(`${baseUrl}/skills/${skillSlug}/files`, {
-        headers,
-    });
-    if (!response.ok) {
-        const errorText = await response.text();
-        if (response.status === 401) {
-            const error = new Error("Unauthorized");
-            error.status = 401;
-            throw error;
-        }
-        if (response.status === 404) {
-            const error = new Error("Skill not found");
-            error.status = 404;
-            throw error;
-        }
-        throw new Error(`Failed to fetch skill files: ${response.status} ${response.statusText}\n${errorText}`);
-    }
-    const data = await response.json();
-    return data.data;
-}
-export async function fetchSkillFile(baseUrl, skillSlug, filePath, auth) {
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (auth) {
-        headers["Authorization"] = `${auth.userAccessKey}:${auth.userOTT}`;
-    }
-    const response = await fetch(`${baseUrl}/skills/${skillSlug}/file/${filePath}`, {
-        headers,
-    });
-    if (!response.ok) {
-        const errorText = await response.text();
-        if (response.status === 401) {
-            const error = new Error("Unauthorized");
-            error.status = 401;
-            throw error;
-        }
-        if (response.status === 404) {
-            const error = new Error("File not found");
-            error.status = 404;
-            throw error;
-        }
-        throw new Error(`Failed to fetch skill file: ${response.status} ${response.statusText}\n${errorText}`);
-    }
-    return response.json();
-}

package/dist/auth.js

@@ -1,117 +0,0 @@
-import { homedir } from "os";
-import { join } from "path";
-import { readFile, writeFile, mkdir } from "fs/promises";
-import { existsSync } from "fs";
-import crypto from "crypto";
-import open from "open";
-const CONFIG_DIR = join(homedir(), ".mcp-s");
-const CONFIG_FILE = join(CONFIG_DIR, "skills-config.json");
-export const generateToken = () => crypto.randomBytes(32).toString("hex");
-export async function loadAuthConfig() {
-    try {
-        if (!existsSync(CONFIG_FILE)) {
-            return null;
-        }
-        const content = await readFile(CONFIG_FILE, "utf-8");
-        return JSON.parse(content);
-    }
-    catch (_a) {
-        return null;
-    }
-}
-export async function saveAuthConfig(config) {
-    if (!existsSync(CONFIG_DIR)) {
-        await mkdir(CONFIG_DIR, { recursive: true });
-    }
-    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
-}
-export async function generateAuthUrl({ baseUrl, userAccessKey, userOTT, }) {
-    const response = await fetch(`${baseUrl}/generate-auth-url`, {
-        method: "POST",
-        headers: {
-            Authorization: `${userAccessKey}:${userOTT}`,
-        },
-    });
-    if (!response.ok) {
-        throw new Error(`Failed to generate auth URL: ${response.status}`);
-    }
-    const { data: { url }, } = await response.json();
-    return url;
-}
-export async function authenticate({ baseUrl, userAccessKey, userOTT, openBrowser = true, }) {
-    const url = await generateAuthUrl({ baseUrl, userAccessKey, userOTT });
-    let opened = false;
-    if (openBrowser) {
-        try {
-            await open(url);
-            opened = true;
-        }
-        catch (_a) {
-            // Browser opening failed, user will need to use the URL manually
-        }
-    }
-    return { url, opened };
-}
-export async function getOrCreateAuth(org, providedUserAccessKey) {
-    const existing = await loadAuthConfig();
-    // If a userAccessKey is provided via CLI, use it
-    if (providedUserAccessKey) {
-        // Check if it matches existing config
-        if (existing &&
-            existing.userAccessKey === providedUserAccessKey &&
-            existing.userOTT &&
-            existing.org === org) {
-            return {
-                userAccessKey: existing.userAccessKey,
-                userOTT: existing.userOTT,
-                isNew: false,
-            };
-        }
-        // New key provided or org changed, generate new OTT
-        const userOTT = generateToken();
-        await saveAuthConfig({
-            userAccessKey: providedUserAccessKey,
-            userOTT,
-            org,
-        });
-        return {
-            userAccessKey: providedUserAccessKey,
-            userOTT,
-            isNew: true,
-        };
-    }
-    if (existing && existing.userAccessKey && existing.userOTT) {
-        // If org changed, generate new OTT
-        if (org && existing.org !== org) {
-            const newOTT = generateToken();
-            await saveAuthConfig(Object.assign(Object.assign({}, existing), { userOTT: newOTT, org }));
-            return {
-                userAccessKey: existing.userAccessKey,
-                userOTT: newOTT,
-                isNew: true,
-            };
-        }
-        return {
-            userAccessKey: existing.userAccessKey,
-            userOTT: existing.userOTT,
-            isNew: false,
-        };
-    }
-    // No existing auth and no key provided - this is an error
-    // The user must provide their userAccessKey
-    throw new Error("No user access key found. Please provide your MCP-S user access key with --key <userAccessKey>");
-}
-export async function refreshToken(org, providedUserAccessKey) {
-    const existing = await loadAuthConfig();
-    const userAccessKey = providedUserAccessKey || (existing === null || existing === void 0 ? void 0 : existing.userAccessKey);
-    if (!userAccessKey) {
-        throw new Error("No user access key found. Please provide your MCP-S user access key with --key <userAccessKey>");
-    }
-    const userOTT = generateToken();
-    await saveAuthConfig({
-        userAccessKey,
-        userOTT,
-        org,
-    });
-    return { userAccessKey, userOTT };
-}