a11y-devkit-deploy 0.4.1 → 0.6.0

package/README.md

@@ -1,101 +1,117 @@
-# A11y Devkit Deploy
-
-A cross-platform CLI for deploying accessibility skills and MCP servers across Claude Code, Cursor, Codex, and VSCode. Automatically clones the a11y-skills repo and all required MCP server repositories.
-
-## Install
-
-```bash
-npm install -g a11y-devkit-deploy
-# or
-npx a11y-devkit-deploy
-```
-
-## Usage
-
-```bash
-a11y-devkit-deploy
-```
-
-### Flags
-
-- `--local` / `--global`: Skip the scope prompt.
-- `--yes`: Use defaults (local scope, all IDEs, install skills).
-
-## What It Does
-
-This CLI automates the setup of accessibility tooling by:
-
-1. **Cloning the a11y-skills repository** - Contains IDE skills for accessibility workflows
-2. **Cloning and building MCP server repositories** - Installs 5 accessibility-focused MCP servers:
-   - **wcag-mcp** - WCAG 2.2 guidelines, success criteria, and techniques
-   - **aria-mcp** - WAI-ARIA roles, states, properties, and patterns
-   - **magentaa11y** - Component accessibility acceptance criteria
-   - **a11y-personas-mcp** - Accessibility personas for diverse user needs
-   - **a11y-issues-template-mcp** - Format AxeCore violations into standardized issue templates
-3. **Installing skills** - Copies skills to IDE-specific directories based on scope (local/global)
-4. **Installing MCP servers** - Copies built MCP servers to home directory:
-   - Single IDE: `~/.{ide}/mcp/servers/` (e.g., `~/.claude/mcp/servers/`)
-   - Multiple IDEs: `~/.mcp/servers/` (shared location)
-5. **Configuring MCP servers** - Updates each IDE's MCP config to enable the accessibility tools
-6. **Cleanup** - Removes temporary build directory after installation
-
-## Configuration
-
-Edit `config/a11y.json` to customize the deployment:
-
-- `repo.url` - Main skills repository to clone
-- `mcpRepos` - Array of MCP repositories to clone and build
-- `skillsSearchPaths` - Directories to search for skills in the cloned repo
-- `ideSkillsPaths` - IDE-specific skills directories (configurable per IDE)
-- `mcpServers` - MCP server definitions with placeholders:
-  - `{mcpRepoDir}` - Path to the MCP servers directory (e.g., `~/.mcp/servers/` or `~/.claude/mcp/servers/`)
-
-## Directory Structure
-
-### Local Install (Project-Specific)
-```
-your-project/
-├── .claude/skills/          # Skills copied to Claude Code (if selected)
-├── .cursor/skills/          # Skills copied to Cursor (if selected)
-├── .codex/skills/           # Skills copied to Codex (if selected)
-└── .github/skills/          # Skills copied here for version control
-```
-
-### Global Install (User-Wide)
-```
-~/.claude/skills/            # Claude Code skills
-~/.cursor/skills/            # Cursor skills
-~/.codex/skills/             # Codex skills
-~/.vscode/skills/            # VSCode skills
-```
-
-### MCP Server Locations
-MCP servers are always installed to the home directory:
-
-**Single IDE Selection:**
-```
-~/.claude/mcp/servers/       # If only Claude Code is selected
-│   ├── wcag-mcp/
-│   ├── aria-mcp/
-│   ├── magentaa11y-mcp/
-│   ├── a11y-personas-mcp/
-│   └── a11y-issues-template-mcp/
-```
-
-**Multiple IDE Selection:**
-```
-~/.mcp/servers/              # Shared location for all selected IDEs
-│   ├── wcag-mcp/
-│   ├── aria-mcp/
-│   ├── magentaa11y-mcp/
-│   ├── a11y-personas-mcp/
-│   └── a11y-issues-template-mcp/
-```
-
-MCP configurations are written to each IDE's OS-specific config path:
-- **macOS**: `~/Library/Application Support/{IDE}/mcp.json`
-- **Windows**: `%APPDATA%\{IDE}\mcp.json`
-- **Linux**: `~/.config/{IDE}/mcp.json`
-
-### Temporary Build Directory
-During installation, repos are cloned and built in a temporary directory (OS temp folder) which is automatically cleaned up after completion.
+# A11y Devkit Deploy
+
+A cross-platform CLI for deploying accessibility skills and MCP servers across Claude Code, Cursor, Codex, and VSCode.
+
+## Install
+
+```bash
+npm install -g a11y-devkit-deploy
+# or
+npx a11y-devkit-deploy
+```
+
+## Usage
+
+```bash
+a11y-devkit-deploy
+```
+
+### Flags
+
+- `--local` / `--global`: Skip the scope prompt.
+- `--yes`: Use defaults (local scope, all IDEs, install skills).
+
+## What It Does
+
+This CLI automates the setup of accessibility tooling by:
+
+1. **Installing skills from npm** - Downloads and installs 7 accessibility skill packages
+2. **Configuring MCP servers** - Updates each IDE's MCP config to enable 5 accessibility-focused MCP servers:
+   - **wcag** - WCAG 2.2 guidelines, success criteria, and techniques
+   - **aria** - WAI-ARIA roles, states, properties, and patterns
+   - **magentaa11y** - Component accessibility acceptance criteria
+   - **a11y-personas** - Accessibility personas for diverse user needs
+   - **arc-issues** - Format AxeCore violations into standardized issue templates
+
+### Skills Installed
+
+The following skill packages are installed from npm:
+
+| Skill | Package | Description |
+|-------|---------|-------------|
+| a11y-base-web | `a11y-base-web-skill` | Foundational accessibility patterns for web code |
+| a11y-issue-writer | `a11y-issue-writer-skill` | Write clear accessibility issue reports |
+| a11y-tester | `a11y-tester-skill` | Automated testing with axe-core and Playwright |
+| a11y-remediator | `a11y-remediator-skill` | Fix accessibility issues in code |
+| a11y-validator | `a11y-validator-skill` | Validate accessibility compliance |
+| web-standards | `web-standards-skill` | Web standards and best practices |
+| a11y-audit-fix-agent-orchestrator | `a11y-audit-fix-agent-orchestrator-skill` | Orchestrate full audit and fix workflows |
+
+### No Local MCP Installation Required!
+
+MCP servers are configured to use `npx`, which means:
+- **No cloning** of MCP server repositories
+- **No building** or `npm install` steps
+- **No disk space** used for local copies
+- **Always up-to-date** - npx fetches the latest version automatically
+
+The generated MCP config looks like this:
+
+```json
+{
+  "mcpServers": {
+    "wcag": {
+      "command": "npx",
+      "args": ["-y", "wcag-mcp"]
+    },
+    "aria": {
+      "command": "npx",
+      "args": ["-y", "aria-mcp"]
+    }
+  }
+}
+```
+
+## Configuration
+
+Edit `config/a11y.json` to customize the deployment:
+
+- `skills` - Array of npm package names to install as skills
+- `ideSkillsPaths` - IDE-specific skills directories (configurable per IDE)
+- `mcpServers` - MCP server definitions using npx
+
+## Directory Structure
+
+### Local Install (Project-Specific)
+```
+your-project/
+├── .claude/skills/          # Skills copied to Claude Code (if selected)
+├── .cursor/skills/          # Skills copied to Cursor (if selected)
+├── .codex/skills/           # Skills copied to Codex (if selected)
+└── .github/skills/          # Skills copied here for version control
+```
+
+### Global Install (User-Wide)
+```
+~/.claude/skills/            # Claude Code skills
+~/.cursor/skills/            # Cursor skills
+~/.codex/skills/             # Codex skills
+~/.vscode/skills/            # VSCode skills
+```
+
+### MCP Configuration Locations
+
+MCP configurations are written to each IDE's OS-specific config path:
+- **macOS**: `~/Library/Application Support/{IDE}/mcp.json`
+- **Windows**: `%APPDATA%\{IDE}\mcp.json`
+- **Linux**: `~/.config/{IDE}/mcp.json`
+
+## MCP Servers Included
+
+| Server | Package | Description |
+|--------|---------|-------------|
+| wcag | `wcag-mcp` | WCAG 2.2 guidelines, success criteria, techniques |
+| aria | `aria-mcp` | WAI-ARIA roles, states, properties |
+| magentaa11y | `magentaa11y-mcp` | Component accessibility acceptance criteria |
+| a11y-personas | `a11y-personas-mcp` | Accessibility personas for diverse users |
+| arc-issues | `arc-issues-mcp` | AxeCore violation formatting |

package/bin/a11y-skills.js

@@ -1,9 +1,9 @@
-#!/usr/bin/env node
-
-import { run } from "../src/cli.js";
-
-run().catch((error) => {
-  const message = error instanceof Error ? error.message : String(error);
-  console.error(`\n[Error] ${message}`);
-  process.exitCode = 1;
+#!/usr/bin/env node
+
+import { run } from "../src/cli.js";
+
+run().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`\n[Error] ${message}`);
+  process.exitCode = 1;
 });

package/config/a11y.json

@@ -1,40 +1,12 @@
 {
-  "repo": {
-    "url": "https://github.com/joe-watkins/a11y-skills",
-    "dirName": "a11y-skills"
-  },
-  "mcpRepos": [
-    {
-      "url": "https://github.com/joe-watkins/wcag-mcp",
-      "dirName": "wcag-mcp",
-      "buildCommands": ["npm install", "npm run build"]
-    },
-    {
-      "url": "https://github.com/joe-watkins/aria-mcp",
-      "dirName": "aria-mcp",
-      "buildCommands": ["npm install"]
-    },
-    {
-      "url": "https://github.com/joe-watkins/magentaa11y-mcp",
-      "dirName": "magentaa11y-mcp",
-      "buildCommands": ["npm install", "npm run update-content"]
-    },
-    {
-      "url": "https://github.com/joe-watkins/a11y-personas-mcp",
-      "dirName": "a11y-personas-mcp",
-      "buildCommands": ["npm install", "npm run build"]
-    },
-    {
-      "url": "https://github.com/joe-watkins/accessibility-issues-template-mcp",
-      "dirName": "a11y-issues-template-mcp",
-      "buildCommands": ["npm install", "npm run build"]
-    }
-  ],
-  "skillsSearchPaths": [
-    ".",
-    "skills",
-    ".github/skills",
-    ".codex/skills"
+  "skills": [
+    "a11y-base-web-skill",
+    "a11y-issue-writer-skill",
+    "a11y-tester-skill",
+    "a11y-remediator-skill",
+    "a11y-validator-skill",
+    "web-standards-skill",
+    "a11y-audit-fix-agent-orchestrator-skill"
   ],
   "ideSkillsPaths": {
     "claude": ".claude/skills",
@@ -45,29 +17,44 @@
   },
   "mcpServers": [
     {
-      "name": "wcag-mcp",
-      "command": "node",
-      "args": ["{mcpRepoDir}/wcag-mcp/src/index.js"]
+      "name": "wcag",
+      "command": "npx",
+      "args": [
+        "-y",
+        "wcag-mcp"
+      ]
     },
     {
-      "name": "aria-mcp",
-      "command": "node",
-      "args": ["{mcpRepoDir}/aria-mcp/src/index.js"]
+      "name": "aria",
+      "command": "npx",
+      "args": [
+        "-y",
+        "aria-mcp"
+      ]
     },
     {
       "name": "magentaa11y",
-      "command": "node",
-      "args": ["{mcpRepoDir}/magentaa11y-mcp/src/index.js"]
-    },
-    {
-      "name": "a11y-personas-mcp",
-      "command": "node",
-      "args": ["{mcpRepoDir}/a11y-personas-mcp/src/index.js"]
-    },
-    {
-      "name": "a11y-issues-template-mcp",
-      "command": "node",
-      "args": ["{mcpRepoDir}/accessibility-issues-template-mcp/build/index.js"]
+      "command": "npx",
+      "args": [
+        "-y",
+        "magentaa11y-mcp"
+      ]
+    },
+    {
+      "name": "a11y-personas",
+      "command": "npx",
+      "args": [
+        "-y",
+        "a11y-personas-mcp"
+      ]
+    },
+    {
+      "name": "arc-issues",
+      "command": "npx",
+      "args": [
+        "-y",
+        "arc-issues-mcp"
+      ]
     }
   ]
 }

package/package.json

@@ -1,49 +1,49 @@
-{
-  "name": "a11y-devkit-deploy",
-  "version": "0.4.1",
-  "description": "CLI to deploy a11y skills and MCP servers across IDEs",
-  "license": "MIT",
-  "type": "module",
-  "main": "src/cli.js",
-  "bin": {
-    "a11y-devkit-deploy": "bin/a11y-skills.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "config",
-    "README.md"
-  ],
-  "keywords": [
-    "accessibility",
-    "a11y",
-    "mcp",
-    "model-context-protocol",
-    "copilot",
-    "skills",
-    "wcag",
-    "aria",
-    "cli"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/joe-watkins/a11y-devkit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/joe-watkins/a11y-devkit/issues"
-  },
-  "homepage": "https://github.com/joe-watkins/a11y-devkit#readme",
-  "author": "Joe Watkins",
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "start": "node bin/a11y-skills.js"
-  },
-  "dependencies": {
-    "boxen": "^5.1.2",
-    "ora": "^6.3.1",
-    "picocolors": "^1.1.0",
-    "prompts": "^2.4.2"
-  }
+{
+  "name": "a11y-devkit-deploy",
+  "version": "0.6.0",
+  "description": "CLI to deploy a11y skills and MCP servers across IDEs",
+  "license": "MIT",
+  "type": "module",
+  "main": "src/cli.js",
+  "bin": {
+    "a11y-devkit-deploy": "bin/a11y-skills.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "config",
+    "README.md"
+  ],
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "mcp",
+    "model-context-protocol",
+    "copilot",
+    "skills",
+    "wcag",
+    "aria",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joe-watkins/a11y-devkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/joe-watkins/a11y-devkit/issues"
+  },
+  "homepage": "https://github.com/joe-watkins/a11y-devkit#readme",
+  "author": "Joe Watkins",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node bin/a11y-skills.js"
+  },
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "ora": "^6.3.1",
+    "picocolors": "^1.1.0",
+    "prompts": "^2.4.2"
+  }
 }

package/src/cli.js

@@ -1,14 +1,12 @@
 import fs from "fs/promises";
-import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
 import prompts from "prompts";
 
 import { header, info, warn, success, startSpinner, formatPath } from "./ui.js";
-import { getPlatform, getIdePaths, getMcpServerDir, getTempDir } from "./paths.js";
-import { ensureRepo, buildMcp, copyMcpServers, cleanupTemp } from "./installers/repo.js";
-import { findSkillsDir, copySkills } from "./installers/skills.js";
-import { resolveServers, installMcpConfig } from "./installers/mcp.js";
+import { getPlatform, getIdePaths, getTempDir } from "./paths.js";
+import { installSkillsFromNpm, cleanupTemp } from "./installers/skills.js";
+import { installMcpConfig } from "./installers/mcp.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -40,7 +38,6 @@ async function run() {
   const config = await loadConfig();
   const idePaths = getIdePaths(projectRoot, platformInfo, config.ideSkillsPaths);
   const args = parseArgs(process.argv);
-  const homeDir = os.homedir();
 
   header("A11y Devkit Deploy", "Install skills + MCP servers across IDEs");
   info(`Detected OS: ${formatOs(platformInfo)}`);
@@ -109,74 +106,30 @@ async function run() {
 
   info(`Install scope: ${scope === "local" ? "Local" : "Global"}`);
 
-  // Create temp directory for cloning and building
+  // Create temp directory for npm install
   const tempDir = path.join(getTempDir(), `.a11y-devkit-${Date.now()}`);
-  const tempSkillsDir = path.join(tempDir, "skills");
-  const tempMcpDir = path.join(tempDir, "mcp");
-
-  // Determine MCP server destination based on IDE selection
-  const mcpServerDir = getMcpServerDir(homeDir, ideSelection);
-  info(`MCP servers: ${formatPath(mcpServerDir)}`);
-
-  // Clone skills repo into temp
-  const repoSpinner = startSpinner("Syncing a11y-skills repo...");
-  const repoResult = await ensureRepo({
-    url: config.repo.url,
-    dir: tempSkillsDir
-  });
-  repoSpinner.succeed(`Repo ${repoResult.action}: ${formatPath(repoResult.dir)}`);
-
-  // Clone and build MCP repos in temp
-  if (config.mcpRepos && config.mcpRepos.length > 0) {
-    const mcpSpinner = startSpinner(`Syncing ${config.mcpRepos.length} MCP repos...`);
-    for (const mcpRepo of config.mcpRepos) {
-      const mcpDir = path.join(tempMcpDir, mcpRepo.dirName);
-      await ensureRepo({
-        url: mcpRepo.url,
-        dir: mcpDir
-      });
-
-      // Build MCP if build commands are specified
-      if (mcpRepo.buildCommands) {
-        mcpSpinner.text = `Building ${mcpRepo.dirName}...`;
-        await buildMcp({
-          dir: mcpDir,
-          buildCommands: mcpRepo.buildCommands
-        });
-      }
-    }
-    mcpSpinner.succeed(`MCP repos synced and built in temp directory`);
-  }
-
-  // Copy MCP servers from temp to final location
-  const copySpinner = startSpinner("Installing MCP servers...");
-  await copyMcpServers(tempMcpDir, mcpServerDir);
-  copySpinner.succeed(`MCP servers installed to ${formatPath(mcpServerDir)}`);
 
   if (installSkills) {
-    const skillsSpinner = startSpinner("Installing skills to IDE folders...");
-    const sourceDir = await findSkillsDir(tempSkillsDir, config.skillsSearchPaths);
-    if (!sourceDir) {
-      skillsSpinner.fail("No skills directory found in repo.");
-    } else {
+    const skillsSpinner = startSpinner("Installing skills from npm...");
+
+    try {
       const skillTargets = scope === "local"
         ? ideSelection.map((ide) => idePaths[ide].localSkillsDir)
         : ideSelection.map((ide) => idePaths[ide].skillsDir);
 
-      for (const target of skillTargets) {
-        await copySkills(sourceDir, target);
-      }
-
-      skillsSpinner.succeed(`Skills installed to ${skillTargets.length} IDE location(s).`);
+      const result = await installSkillsFromNpm(config.skills, skillTargets, tempDir);
+      skillsSpinner.succeed(`${result.installed} skills installed to ${skillTargets.length} IDE location(s).`);
+    } catch (error) {
+      skillsSpinner.fail(`Failed to install skills: ${error.message}`);
     }
   } else {
     warn("Skipping skills install to IDE folders.");
   }
 
-  const serverDefs = resolveServers(config.mcpServers, mcpServerDir, mcpServerDir);
+  // Configure MCP servers using npx (no local installation needed!)
   const mcpSpinner = startSpinner("Updating MCP configurations...");
   for (const ide of ideSelection) {
-    await installMcpConfig(idePaths[ide].mcpConfig, serverDefs, idePaths[ide].mcpServerKey);
+    await installMcpConfig(idePaths[ide].mcpConfig, config.mcpServers, idePaths[ide].mcpServerKey);
   }
   mcpSpinner.succeed(`MCP configs updated for ${ideSelection.length} IDE(s).`);
 
@@ -186,9 +139,11 @@ async function run() {
   cleanupSpinner.succeed("Temporary files removed");
 
   success("All done. Your skills and MCP servers are ready.");
-  info("You can re-run this CLI any time to update the repo and configs.");
+  info("Skills installed from npm packages.");
+  info("MCP servers use npx - no local installation needed!");
+  info("You can re-run this CLI any time to update skills and configs.");
 }
 
 export {
   run
-};
+};

package/src/installers/mcp.js

@@ -25,18 +25,6 @@ async function loadJson(filePath) {
   }
 }
 
-function resolveServers(servers, repoDir, mcpRepoDir) {
-  return servers.map((server) => {
-    const args = Array.isArray(server.args) ? server.args : [];
-    return {
-      ...server,
-      args: args.map((value) => 
-        value.replace("{repoDir}", repoDir).replace("{mcpRepoDir}", mcpRepoDir)
-      )
-    };
-  });
-}
-
 function mergeServers(existing, incoming, serverKey = "servers") {
   const existingServers = existing[serverKey] && typeof existing[serverKey] === "object"
     ? existing[serverKey]
@@ -47,9 +35,7 @@ function mergeServers(existing, incoming, serverKey = "servers") {
   for (const server of incoming) {
     merged[serverKey][server.name] = {
       command: server.command,
-      args: server.args || [],
-      env: server.env || {},
-      cwd: server.cwd
+      args: server.args || []
     };
   }
 
@@ -64,6 +50,5 @@ async function installMcpConfig(configPath, servers, serverKey = "servers") {
 }
 
 export {
-  resolveServers,
   installMcpConfig
-};
+};

package/src/installers/skills.js

@@ -1,31 +1,110 @@
-import fs from "fs/promises";
-import path from "path";
-
-async function pathExists(target) {
-  try {
-    await fs.access(target);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function findSkillsDir(repoDir, candidates) {
-  for (const candidate of candidates) {
-    const fullPath = path.join(repoDir, candidate);
-    if (await pathExists(fullPath)) {
-      return fullPath;
-    }
-  }
-  return null;
-}
-
-async function copySkills(sourceDir, targetDir) {
-  await fs.mkdir(targetDir, { recursive: true });
-  await fs.cp(sourceDir, targetDir, { recursive: true, force: true });
-}
-
-export {
-  findSkillsDir,
-  copySkills
+import fs from "fs/promises";
+import path from "path";
+import { spawn } from "child_process";
+
+async function pathExists(target) {
+  try {
+    await fs.access(target);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function run(command, args, options = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { stdio: "pipe", ...options });
+    let stdout = "";
+    let stderr = "";
+    
+    child.stdout?.on("data", (data) => { stdout += data; });
+    child.stderr?.on("data", (data) => { stderr += data; });
+    
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve({ stdout, stderr });
+        return;
+      }
+      reject(new Error(`${command} ${args.join(" ")} failed with code ${code}: ${stderr}`));
+    });
+  });
+}
+
+async function cleanupTemp(tempDir) {
+  if (await pathExists(tempDir)) {
+    await fs.rm(tempDir, { recursive: true, force: true });
+  }
+}
+
+/**
+ * Install skills from npm packages into IDE skills directories.
+ * 
+ * 1. Creates temp directory with package.json listing skills as dependencies
+ * 2. Runs npm install in temp directory
+ * 3. Copies installed skill packages (SKILL.md files) to target directories
+ * 4. Returns temp directory path for cleanup
+ * 
+ * @param {string[]} skills - Array of npm package names
+ * @param {string[]} targetDirs - Array of target directories to install skills to
+ * @param {string} tempDir - Temporary directory for npm install
+ * @returns {Promise<{installed: number, tempDir: string}>}
+ */
+async function installSkillsFromNpm(skills, targetDirs, tempDir) {
+  // Create temp directory
+  await fs.mkdir(tempDir, { recursive: true });
+
+  // Create package.json with skills as dependencies
+  const packageJson = {
+    name: "a11y-skills-temp",
+    version: "1.0.0",
+    private: true,
+    dependencies: {}
+  };
+
+  for (const skill of skills) {
+    packageJson.dependencies[skill] = "latest";
+  }
+
+  await fs.writeFile(
+    path.join(tempDir, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+
+  // Run npm install
+  await run("npm", ["install", "--production"], { cwd: tempDir });
+
+  // Copy SKILL.md files from installed packages to target directories
+  const nodeModulesDir = path.join(tempDir, "node_modules");
+  let installedCount = 0;
+
+  for (const targetDir of targetDirs) {
+    await fs.mkdir(targetDir, { recursive: true });
+
+    for (const skill of skills) {
+      const skillPackageDir = path.join(nodeModulesDir, skill);
+      const skillMdPath = path.join(skillPackageDir, "SKILL.md");
+
+      if (await pathExists(skillMdPath)) {
+        // Create skill directory in target (use package name without -skill suffix)
+        const skillDirName = skill.replace(/-skill$/, "");
+        const targetSkillDir = path.join(targetDir, skillDirName);
+        await fs.mkdir(targetSkillDir, { recursive: true });
+
+        // Copy SKILL.md
+        await fs.copyFile(skillMdPath, path.join(targetSkillDir, "SKILL.md"));
+        installedCount++;
+      }
+    }
+  }
+
+  return { 
+    installed: installedCount / targetDirs.length, 
+    tempDir 
+  };
+}
+
+export {
+  installSkillsFromNpm,
+  cleanupTemp
 };

package/src/paths.js

@@ -30,15 +30,6 @@ function getAppSupportDir(platformInfo = getPlatform()) {
   return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
 }
 
-function getMcpServerDir(home, ideSelection) {
-  // Single IDE: use IDE-specific path (~/.claude/mcp/servers/)
-  // Multiple IDEs: use shared path (~/.mcp/servers/)
-  if (ideSelection.length === 1) {
-    return path.join(home, `.${ideSelection[0]}`, "mcp", "servers");
-  }
-  return path.join(home, ".mcp", "servers");
-}
-
 function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths = null) {
   const appSupport = getAppSupportDir(platformInfo);
   const home = os.homedir();
@@ -88,6 +79,5 @@ export {
   getPlatform,
   getAppSupportDir,
   getIdePaths,
-  getMcpServerDir,
   getTempDir
 };

package/src/ui.js

@@ -1,57 +1,57 @@
-import boxen from "boxen";
-import pc from "picocolors";
-import ora from "ora";
-
-const bullets = {
-  info: pc.cyan("i"),
-  warn: pc.yellow("!"),
-  error: pc.red("x"),
-  success: pc.green("ok")
-};
-
-function header(title, subtitle) {
-  const line = subtitle ? `${pc.dim(subtitle)}` : "";
-  const content = [pc.bold(title), line].filter(Boolean).join("\n");
-  console.log(
-    boxen(content, {
-      padding: 1,
-      margin: { top: 1, bottom: 1 },
-      borderStyle: "round",
-      borderColor: "cyan"
-    })
-  );
-}
-
-function info(message) {
-  console.log(`${bullets.info} ${message}`);
-}
-
-function warn(message) {
-  console.log(`${bullets.warn} ${message}`);
-}
-
-function success(message) {
-  console.log(`${bullets.success} ${message}`);
-}
-
-function error(message) {
-  console.log(`${bullets.error} ${message}`);
-}
-
-function startSpinner(text) {
-  return ora({ text, spinner: "dots" }).start();
-}
-
-function formatPath(value) {
-  return pc.dim(value);
-}
-
-export {
-  header,
-  info,
-  warn,
-  success,
-  error,
-  startSpinner,
-  formatPath
+import boxen from "boxen";
+import pc from "picocolors";
+import ora from "ora";
+
+const bullets = {
+  info: pc.cyan("i"),
+  warn: pc.yellow("!"),
+  error: pc.red("x"),
+  success: pc.green("ok")
+};
+
+function header(title, subtitle) {
+  const line = subtitle ? `${pc.dim(subtitle)}` : "";
+  const content = [pc.bold(title), line].filter(Boolean).join("\n");
+  console.log(
+    boxen(content, {
+      padding: 1,
+      margin: { top: 1, bottom: 1 },
+      borderStyle: "round",
+      borderColor: "cyan"
+    })
+  );
+}
+
+function info(message) {
+  console.log(`${bullets.info} ${message}`);
+}
+
+function warn(message) {
+  console.log(`${bullets.warn} ${message}`);
+}
+
+function success(message) {
+  console.log(`${bullets.success} ${message}`);
+}
+
+function error(message) {
+  console.log(`${bullets.error} ${message}`);
+}
+
+function startSpinner(text) {
+  return ora({ text, spinner: "dots" }).start();
+}
+
+function formatPath(value) {
+  return pc.dim(value);
+}
+
+export {
+  header,
+  info,
+  warn,
+  success,
+  error,
+  startSpinner,
+  formatPath
 };

package/src/installers/repo.js

@@ -1,103 +0,0 @@
-import fs from "fs/promises";
-import path from "path";
-import { spawn } from "child_process";
-
-async function pathExists(target) {
-  try {
-    await fs.access(target);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function run(command, args, options = {}) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, { stdio: "inherit", ...options });
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (code === 0) {
-        resolve();
-        return;
-      }
-      reject(new Error(`${command} ${args.join(" ")} failed with code ${code}`));
-    });
-  });
-}
-
-async function ensureRepo({ url, dir }) {
-  const hasDir = await pathExists(dir);
-  const gitDir = path.join(dir, ".git");
-
-  if (hasDir) {
-    const isGitRepo = await pathExists(gitDir);
-    if (!isGitRepo) {
-      throw new Error(`Target exists but is not a git repo: ${dir}`);
-    }
-
-    await run("git", ["-C", dir, "pull", "--ff-only"]);
-    return { action: "updated", dir };
-  }
-
-  await run("git", ["clone", "--depth", "1", url, dir]);
-  return { action: "cloned", dir };
-}
-
-async function buildMcp({ dir, buildCommands }) {
-  if (!buildCommands || buildCommands.length === 0) {
-    return;
-  }
-
-  for (const command of buildCommands) {
-    const parts = command.split(" ");
-    const cmd = parts[0];
-    const args = parts.slice(1);
-    await run(cmd, args, { cwd: dir, shell: true });
-  }
-}
-
-async function copyDirectory(source, dest) {
-  await fs.mkdir(dest, { recursive: true });
-  const entries = await fs.readdir(source, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(source, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      await copyDirectory(srcPath, destPath);
-    } else {
-      await fs.copyFile(srcPath, destPath);
-    }
-  }
-}
-
-async function copyMcpServers(tempMcpDir, finalMcpDir) {
-  if (!(await pathExists(tempMcpDir))) {
-    return;
-  }
-
-  await fs.mkdir(finalMcpDir, { recursive: true });
-  const entries = await fs.readdir(tempMcpDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (entry.isDirectory()) {
-      const srcPath = path.join(tempMcpDir, entry.name);
-      const destPath = path.join(finalMcpDir, entry.name);
-      await copyDirectory(srcPath, destPath);
-    }
-  }
-}
-
-async function cleanupTemp(tempDir) {
-  if (await pathExists(tempDir)) {
-    await fs.rm(tempDir, { recursive: true, force: true });
-  }
-}
-
-export {
-  ensureRepo,
-  buildMcp,
-  copyMcpServers,
-  cleanupTemp
-};