@orderful/droid 0.17.2 → 0.19.0

package/.github/workflows/claude-code-review.yml

@@ -0,0 +1,58 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    # Run only when PR is opened or converted from draft to ready
+    types: [opened, ready_for_review]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

package/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @orderful/droid
 
+## 0.19.0
+
+### Minor Changes
+
+- [#104](https://github.com/Orderful/droid/pull/104) [`b6eaef4`](https://github.com/Orderful/droid/commit/b6eaef4fb3b003d41b5451e7efdba633a50b525e) Thanks [@frytyler](https://github.com/frytyler)! - Add tool migration system and fix skill config paths
+  - **Migration system**: Tools can now define migrations that run after install/update. Migrations are tracked per-tool in config and logged to `~/.droid/.migrations.log`.
+  - **Config path fix**: Skill overrides now save to unprefixed paths (`~/.droid/skills/brain/` not `~/.droid/skills/droid-brain/`), matching what SKILL.md tells Claude to read.
+  - **Automatic migration**: Existing users with prefixed config directories will have them automatically migrated on tool update.
+
+  Tool version bumps:
+  - brain: 0.2.2 → 0.2.3
+  - comments: 0.2.5 → 0.2.6
+  - project: 0.1.4 → 0.1.5
+  - coach: 0.1.2 → 0.1.3
+
+## 0.18.0
+
+### Minor Changes
+
+- [#102](https://github.com/Orderful/droid/pull/102) [`e45e61d`](https://github.com/Orderful/droid/commit/e45e61d812fe9d58288d7976650dda474f568516) Thanks [@frytyler](https://github.com/frytyler)! - **BREAKING:** Rename skill directories to `droid-*` prefix as workaround for Claude Code bug
+
+  > **Versioning Note:** This changeset uses `minor` for the droid package (0.17.2 → 0.18.0) per pre-1.0 semver convention where breaking changes are allowed in minor bumps. Individual tool versions receive `patch` bumps (0.2.4 → 0.2.5, etc.) since the tool interface remains unchanged - only internal skill directories are renamed.
+
+  Claude Code v2.0.75+ blocks direct user invocation of slash commands when a skill directory has the same name as the command. Renamed all skill directories from `{name}/` to `droid-{name}/` to avoid collision:
+  - `comments/` → `droid-comments/`
+  - `code-review/` → `droid-code-review/`
+  - `coach/` → `droid-coach/`
+  - `project/` → `droid-project/`
+  - `brain/` → `droid-brain/`
+  - `brain-obsidian/` → `droid-brain-obsidian/`
+
+  Command names remain unchanged (`/brain`, `/comments`, etc.). Tool names also remain unchanged - only internal skill directories are renamed.
+
+  **Migration:** After updating, affected tools will show as "update available" in the TUI. Click "Update" to automatically migrate to new skill directories. Old directories and config entries are automatically cleaned up during update - no manual intervention needed.
+
+  Bug report: https://github.com/anthropics/claude-code/issues/14945
+
 ## 0.17.2
 
 ### Patch Changes

package/dist/bin/droid.js

@@ -7,8 +7,8 @@ import { program } from "commander";
 import inquirer from "inquirer";
 import chalk2 from "chalk";
 import { execSync as execSync2 } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5 } from "fs";
+import { join as join8 } from "path";
 import { homedir as homedir3 } from "os";
 
 // src/lib/config.ts
@@ -126,8 +126,15 @@ function setConfigValue(key, value) {
 function getConfigPath() {
   return CONFIG_FILE;
 }
+function getConfigDir() {
+  return CONFIG_DIR;
+}
+function normalizeSkillNameForConfig(skillName) {
+  return skillName.replace(/^droid-/, "");
+}
 function getSkillOverridesPath(skillName) {
-  return join(CONFIG_DIR, "skills", skillName, "overrides.yaml");
+  const normalizedName = normalizeSkillNameForConfig(skillName);
+  return join(CONFIG_DIR, "skills", normalizedName, "overrides.yaml");
 }
 function loadSkillOverrides(skillName) {
   const overridesPath = getSkillOverridesPath(skillName);
@@ -142,8 +149,9 @@ function loadSkillOverrides(skillName) {
   }
 }
 function saveSkillOverrides(skillName, overrides) {
+  const normalizedName = normalizeSkillNameForConfig(skillName);
   const overridesPath = getSkillOverridesPath(skillName);
-  const skillDir = join(CONFIG_DIR, "skills", skillName);
+  const skillDir = join(CONFIG_DIR, "skills", normalizedName);
   if (!existsSync(skillDir)) {
     mkdirSync(skillDir, { recursive: true });
   }
@@ -168,8 +176,8 @@ function setAutoUpdateConfig(updates) {
 }
 
 // src/lib/skills.ts
-import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, rmSync } from "fs";
-import { join as join6, dirname as dirname4 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync5, mkdirSync as mkdirSync4, writeFileSync as writeFileSync3, rmSync as rmSync2 } from "fs";
+import { join as join7, dirname as dirname5, basename } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import YAML4 from "yaml";
 
@@ -334,6 +342,16 @@ function getInstalledToolVersion(toolName) {
     if (installedTools[skillName]) {
       return installedTools[skillName].version;
     }
+    if (skillName.startsWith("droid-")) {
+      const oldSkillName = skillName.replace(/^droid-/, "");
+      if (installedTools[oldSkillName]) {
+        const version2 = installedTools[oldSkillName].version;
+        delete installedTools[oldSkillName];
+        setPlatformTools(config, installedTools);
+        saveConfig(config);
+        return version2;
+      }
+    }
   }
   return null;
 }
@@ -498,11 +516,104 @@ function uninstallAgent(agentName) {
   }
 }
 
+// src/lib/migrations.ts
+import { existsSync as existsSync4, appendFileSync, mkdirSync as mkdirSync3, renameSync, rmSync } from "fs";
+import { join as join6, dirname as dirname4 } from "path";
+var MIGRATIONS_LOG_FILE = ".migrations.log";
+function getMigrationsLogPath() {
+  return join6(getConfigDir(), MIGRATIONS_LOG_FILE);
+}
+function logMigration(toolName, fromVersion, toVersion, status, error) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const logEntry = error ? `${timestamp} ${toolName} ${fromVersion} \u2192 ${toVersion} ${status}: ${error}
+` : `${timestamp} ${toolName} ${fromVersion} \u2192 ${toVersion} ${status}
+`;
+  const logPath = getMigrationsLogPath();
+  const logDir = dirname4(logPath);
+  if (!existsSync4(logDir)) {
+    mkdirSync3(logDir, { recursive: true });
+  }
+  appendFileSync(logPath, logEntry);
+}
+function createConfigDirMigration(skillName, version2) {
+  const unprefixedName = skillName.replace(/^droid-/, "");
+  return {
+    version: version2,
+    description: `Move ${skillName} config to unprefixed location`,
+    up: (configDir) => {
+      const oldDir = join6(configDir, "skills", skillName);
+      const newDir = join6(configDir, "skills", unprefixedName);
+      if (existsSync4(oldDir) && !existsSync4(newDir)) {
+        const parentDir = dirname4(newDir);
+        if (!existsSync4(parentDir)) {
+          mkdirSync3(parentDir, { recursive: true });
+        }
+        renameSync(oldDir, newDir);
+      } else if (existsSync4(oldDir) && existsSync4(newDir)) {
+        rmSync(oldDir, { recursive: true });
+      }
+    }
+  };
+}
+var TOOL_MIGRATIONS = {
+  brain: [createConfigDirMigration("droid-brain", "0.2.3")],
+  comments: [createConfigDirMigration("droid-comments", "0.2.6")],
+  project: [createConfigDirMigration("droid-project", "0.1.5")],
+  coach: [createConfigDirMigration("droid-coach", "0.1.3")]
+};
+function getToolMigrations(toolName) {
+  return TOOL_MIGRATIONS[toolName] ?? [];
+}
+function getLastMigratedVersion(toolName) {
+  const config = loadConfig();
+  return config.migrations?.[toolName] ?? "0.0.0";
+}
+function setLastMigratedVersion(toolName, version2) {
+  const config = loadConfig();
+  if (!config.migrations) {
+    config.migrations = {};
+  }
+  config.migrations[toolName] = version2;
+  saveConfig(config);
+}
+function runMigrations(toolName, fromVersion, toVersion) {
+  const migrations = getToolMigrations(toolName);
+  const pendingMigrations = migrations.filter((m) => {
+    const afterFrom = compareSemver(m.version, fromVersion) > 0;
+    const beforeOrAtTo = compareSemver(m.version, toVersion) <= 0;
+    return afterFrom && beforeOrAtTo;
+  });
+  if (pendingMigrations.length === 0) {
+    setLastMigratedVersion(toolName, toVersion);
+    return { success: true };
+  }
+  const configDir = getConfigDir();
+  for (const migration of pendingMigrations) {
+    try {
+      migration.up(configDir);
+      logMigration(toolName, fromVersion, migration.version, "OK");
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logMigration(toolName, fromVersion, migration.version, "FAILED", errorMessage);
+      return { success: false, error: `Migration ${migration.version} failed: ${errorMessage}` };
+    }
+  }
+  setLastMigratedVersion(toolName, toVersion);
+  return { success: true };
+}
+function runToolMigrations(toolName, installedVersion) {
+  const lastMigrated = getLastMigratedVersion(toolName);
+  if (compareSemver(installedVersion, lastMigrated) <= 0) {
+    return { success: true };
+  }
+  return runMigrations(toolName, lastMigrated, installedVersion);
+}
+
 // src/lib/skills.ts
 var DROID_SKILLS_START = "<!-- droid-skills-start -->";
 var DROID_SKILLS_END = "<!-- droid-skills-end -->";
-var __dirname4 = dirname4(fileURLToPath4(import.meta.url));
-var BUNDLED_SKILLS_DIR = join6(__dirname4, "../tools");
+var __dirname4 = dirname5(fileURLToPath4(import.meta.url));
+var BUNDLED_SKILLS_DIR = join7(__dirname4, "../tools");
 function getSkillsInstallPath(platform) {
   return getSkillsPath(platform);
 }
@@ -515,7 +626,7 @@ function getPlatformConfigPath(platform) {
 function updatePlatformConfigSkills(platform, installedSkills) {
   const configPath = getPlatformConfigPath(platform);
   let content = "";
-  if (existsSync4(configPath)) {
+  if (existsSync5(configPath)) {
     content = readFileSync5(configPath, "utf-8");
   }
   const skillLines = installedSkills.map((name) => {
@@ -534,9 +645,9 @@ ${DROID_SKILLS_END}` : "";
   } else if (skillsSection) {
     content = content.trim() + "\n\n" + skillsSection + "\n";
   }
-  const configDir = dirname4(configPath);
-  if (!existsSync4(configDir)) {
-    mkdirSync3(configDir, { recursive: true });
+  const configDir = dirname5(configPath);
+  if (!existsSync5(configDir)) {
+    mkdirSync4(configDir, { recursive: true });
   }
   writeFileSync3(configPath, content, "utf-8");
 }
@@ -557,8 +668,8 @@ function parseSkillFrontmatter(content) {
   }
 }
 function loadSkillManifest(skillDir) {
-  const skillMdPath = join6(skillDir, "SKILL.md");
-  if (!existsSync4(skillMdPath)) {
+  const skillMdPath = join7(skillDir, "SKILL.md");
+  if (!existsSync5(skillMdPath)) {
     return null;
   }
   const content = readFileSync5(skillMdPath, "utf-8");
@@ -566,7 +677,7 @@ function loadSkillManifest(skillDir) {
   if (!frontmatter || !frontmatter.name) {
     return null;
   }
-  const toolDir = dirname4(dirname4(skillDir));
+  const toolDir = dirname5(dirname5(skillDir));
   const toolManifest = loadToolManifest(toolDir);
   return {
     name: frontmatter.name,
@@ -578,17 +689,17 @@ function loadSkillManifest(skillDir) {
   };
 }
 function findSkillPath(skillName) {
-  if (!existsSync4(BUNDLED_SKILLS_DIR)) {
+  if (!existsSync5(BUNDLED_SKILLS_DIR)) {
     return null;
   }
   const toolDirs = readdirSync3(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
   for (const toolName of toolDirs) {
-    const skillsDir = join6(BUNDLED_SKILLS_DIR, toolName, "skills");
-    if (!existsSync4(skillsDir)) continue;
-    const skillDir = join6(skillsDir, skillName);
-    if (existsSync4(skillDir) && existsSync4(join6(skillDir, "SKILL.md"))) {
+    const skillsDir = join7(BUNDLED_SKILLS_DIR, toolName, "skills");
+    if (!existsSync5(skillsDir)) continue;
+    const skillDir = join7(skillsDir, skillName);
+    if (existsSync5(skillDir) && existsSync5(join7(skillDir, "SKILL.md"))) {
       return {
-        toolDir: join6(BUNDLED_SKILLS_DIR, toolName),
+        toolDir: join7(BUNDLED_SKILLS_DIR, toolName),
         skillDir
       };
     }
@@ -596,17 +707,17 @@ function findSkillPath(skillName) {
   return null;
 }
 function getBundledSkills() {
-  if (!existsSync4(BUNDLED_SKILLS_DIR)) {
+  if (!existsSync5(BUNDLED_SKILLS_DIR)) {
     return [];
   }
   const toolDirs = readdirSync3(BUNDLED_SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
   const skills = [];
   for (const toolName of toolDirs) {
-    const skillsDir = join6(BUNDLED_SKILLS_DIR, toolName, "skills");
-    if (!existsSync4(skillsDir)) continue;
+    const skillsDir = join7(BUNDLED_SKILLS_DIR, toolName, "skills");
+    if (!existsSync5(skillsDir)) continue;
     const skillSubdirs = readdirSync3(skillsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
     for (const skillName of skillSubdirs) {
-      const manifest = loadSkillManifest(join6(skillsDir, skillName));
+      const manifest = loadSkillManifest(join7(skillsDir, skillName));
       if (manifest) {
         skills.push(manifest);
       }
@@ -683,17 +794,33 @@ function installSkill(skillName) {
     }
   }
   const skillsPath = getSkillsInstallPath(config.platform);
-  const targetSkillDir = join6(skillsPath, skillName);
+  const targetSkillDir = join7(skillsPath, skillName);
   const commandsPath = getCommandsInstallPath(config.platform);
   const tools = getPlatformTools(config);
-  const commandsSource = join6(toolDir, "commands");
-  const agentsSource = join6(toolDir, "agents");
+  if (skillName.startsWith("droid-")) {
+    const oldSkillName = skillName.replace(/^droid-/, "");
+    const oldSkillDir = join7(skillsPath, oldSkillName);
+    if (existsSync5(oldSkillDir)) {
+      try {
+        rmSync2(oldSkillDir, { recursive: true });
+      } catch (error) {
+        console.warn(`Warning: Could not remove old skill directory ${oldSkillDir}: ${error}`);
+      }
+    }
+    if (tools[oldSkillName]) {
+      delete tools[oldSkillName];
+      setPlatformTools(config, tools);
+      saveConfig(config);
+    }
+  }
+  const commandsSource = join7(toolDir, "commands");
+  const agentsSource = join7(toolDir, "agents");
   if (!tools[skillName]) {
-    if (existsSync4(commandsSource)) {
+    if (existsSync5(commandsSource)) {
       const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
       for (const file of commandFiles) {
-        const targetCommandPath = join6(commandsPath, file);
-        if (existsSync4(targetCommandPath)) {
+        const targetCommandPath = join7(commandsPath, file);
+        if (existsSync5(targetCommandPath)) {
           const commandName = file.replace(".md", "");
           return {
             success: false,
@@ -702,7 +829,7 @@ function installSkill(skillName) {
         }
       }
     }
-    if (existsSync4(agentsSource)) {
+    if (existsSync5(agentsSource)) {
       const agentDirs = readdirSync3(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
       for (const agentName of agentDirs) {
         if (isAgentInstalled(agentName)) {
@@ -714,49 +841,49 @@ function installSkill(skillName) {
       }
     }
   }
-  if (!existsSync4(skillsPath)) {
-    mkdirSync3(skillsPath, { recursive: true });
+  if (!existsSync5(skillsPath)) {
+    mkdirSync4(skillsPath, { recursive: true });
   }
-  const skillMdSource = join6(skillDir, "SKILL.md");
-  if (existsSync4(skillMdSource)) {
-    if (!existsSync4(targetSkillDir)) {
-      mkdirSync3(targetSkillDir, { recursive: true });
+  const skillMdSource = join7(skillDir, "SKILL.md");
+  if (existsSync5(skillMdSource)) {
+    if (!existsSync5(targetSkillDir)) {
+      mkdirSync4(targetSkillDir, { recursive: true });
     }
-    const skillMdTarget = join6(targetSkillDir, "SKILL.md");
+    const skillMdTarget = join7(targetSkillDir, "SKILL.md");
     const content = readFileSync5(skillMdSource, "utf-8");
     writeFileSync3(skillMdTarget, content);
   }
-  const referencesSource = join6(skillDir, "references");
-  if (existsSync4(referencesSource)) {
-    const targetReferencesDir = join6(targetSkillDir, "references");
-    if (!existsSync4(targetReferencesDir)) {
-      mkdirSync3(targetReferencesDir, { recursive: true });
+  const referencesSource = join7(skillDir, "references");
+  if (existsSync5(referencesSource)) {
+    const targetReferencesDir = join7(targetSkillDir, "references");
+    if (!existsSync5(targetReferencesDir)) {
+      mkdirSync4(targetReferencesDir, { recursive: true });
     }
     const referenceFiles = readdirSync3(referencesSource).filter((f) => f.endsWith(".md"));
     for (const file of referenceFiles) {
-      const sourcePath = join6(referencesSource, file);
-      const targetPath = join6(targetReferencesDir, file);
+      const sourcePath = join7(referencesSource, file);
+      const targetPath = join7(targetReferencesDir, file);
       const content = readFileSync5(sourcePath, "utf-8");
       writeFileSync3(targetPath, content);
     }
   }
-  if (existsSync4(commandsSource)) {
-    if (!existsSync4(commandsPath)) {
-      mkdirSync3(commandsPath, { recursive: true });
+  if (existsSync5(commandsSource)) {
+    if (!existsSync5(commandsPath)) {
+      mkdirSync4(commandsPath, { recursive: true });
     }
     const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
     for (const file of commandFiles) {
-      const sourcePath = join6(commandsSource, file);
-      const targetPath = join6(commandsPath, file);
+      const sourcePath = join7(commandsSource, file);
+      const targetPath = join7(commandsPath, file);
       const content = readFileSync5(sourcePath, "utf-8");
       writeFileSync3(targetPath, content);
     }
   }
   const installedAgents = [];
-  if (existsSync4(agentsSource)) {
+  if (existsSync5(agentsSource)) {
     const agentDirs = readdirSync3(agentsSource, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
     for (const agentName of agentDirs) {
-      const agentDir = join6(agentsSource, agentName);
+      const agentDir = join7(agentsSource, agentName);
       const result = installAgentFromPath(agentDir, agentName);
       if (result.success) {
         installedAgents.push(agentName);
@@ -775,6 +902,11 @@ function installSkill(skillName) {
   saveConfig(config);
   const installedSkillNames = Object.keys(updatedTools);
   updatePlatformConfigSkills(config.platform, installedSkillNames);
+  const toolName = basename(toolDir);
+  const migrationResult = runToolMigrations(toolName, manifest.version);
+  if (!migrationResult.success) {
+    console.warn(`Warning: Migration failed for ${toolName}: ${migrationResult.error}`);
+  }
   return { success: true, message: `Installed ${skillName} v${manifest.version}` };
 }
 function uninstallSkill(skillName) {
@@ -784,19 +916,19 @@ function uninstallSkill(skillName) {
     return { success: false, message: `Skill '${skillName}' is not installed` };
   }
   const skillsPath = getSkillsInstallPath(config.platform);
-  const skillDir = join6(skillsPath, skillName);
-  if (existsSync4(skillDir)) {
-    rmSync(skillDir, { recursive: true });
+  const skillDir = join7(skillsPath, skillName);
+  if (existsSync5(skillDir)) {
+    rmSync2(skillDir, { recursive: true });
   }
   const skillPath = findSkillPath(skillName);
   const commandsPath = getCommandsInstallPath(config.platform);
-  const commandsSource = skillPath ? join6(skillPath.toolDir, "commands") : null;
-  if (commandsSource && existsSync4(commandsSource)) {
+  const commandsSource = skillPath ? join7(skillPath.toolDir, "commands") : null;
+  if (commandsSource && existsSync5(commandsSource)) {
     const commandFiles = readdirSync3(commandsSource).filter((f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md");
     for (const file of commandFiles) {
-      const commandPath = join6(commandsPath, file);
-      if (existsSync4(commandPath)) {
-        rmSync(commandPath);
+      const commandPath = join7(commandsPath, file);
+      if (existsSync5(commandPath)) {
+        rmSync2(commandPath);
       }
     }
   }
@@ -846,13 +978,13 @@ var OPENCODE_SKILLS_PLUGIN = "opencode-skills";
 function configurePlatformPermissions(platform) {
   const added = [];
   if (platform === "claude-code" /* ClaudeCode */) {
-    const settingsPath = join7(homedir3(), ".claude", "settings.json");
-    const claudeDir = join7(homedir3(), ".claude");
-    if (!existsSync5(claudeDir)) {
-      mkdirSync4(claudeDir, { recursive: true });
+    const settingsPath = join8(homedir3(), ".claude", "settings.json");
+    const claudeDir = join8(homedir3(), ".claude");
+    if (!existsSync6(claudeDir)) {
+      mkdirSync5(claudeDir, { recursive: true });
     }
     let settings = {};
-    if (existsSync5(settingsPath)) {
+    if (existsSync6(settingsPath)) {
       try {
         settings = JSON.parse(readFileSync6(settingsPath, "utf-8"));
       } catch {
@@ -883,13 +1015,13 @@ function configurePlatformPermissions(platform) {
     return { added, alreadyPresent: added.length === 0 };
   }
   if (platform === "opencode" /* OpenCode */) {
-    const globalConfigDir = join7(homedir3(), ".config", "opencode");
-    const globalConfigPath = join7(globalConfigDir, "opencode.json");
-    if (!existsSync5(globalConfigDir)) {
-      mkdirSync4(globalConfigDir, { recursive: true });
+    const globalConfigDir = join8(homedir3(), ".config", "opencode");
+    const globalConfigPath = join8(globalConfigDir, "opencode.json");
+    if (!existsSync6(globalConfigDir)) {
+      mkdirSync5(globalConfigDir, { recursive: true });
     }
     let config = {};
-    if (existsSync5(globalConfigPath)) {
+    if (existsSync6(globalConfigPath)) {
       try {
         config = JSON.parse(readFileSync6(globalConfigPath, "utf-8"));
       } catch {
@@ -1154,8 +1286,9 @@ async function promptForSkillConfig(skillName, configSchema, askFirst = true) {
   }
   if (Object.keys(overrides).length > 0) {
     saveSkillOverrides(skillName, overrides);
+    const displayName = skillName.replace(/^droid-/, "");
     console.log(chalk4.green(`
-\u2713 Configuration saved to ~/.droid/skills/${skillName}/overrides.yaml`));
+\u2713 Configuration saved to ~/.droid/skills/${displayName}/overrides.yaml`));
   } else {
     console.log(chalk4.gray("\nNo custom configuration set (using defaults)."));
   }
@@ -2214,8 +2347,8 @@ function ReadmeViewer({ title, content, onClose }) {
 // src/commands/tui/views/ToolExplorer.tsx
 import { Box as Box10, Text as Text11, useInput as useInput5 } from "ink";
 import { useState as useState5, useMemo as useMemo3 } from "react";
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
+import { join as join9 } from "path";
 import { jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
 function ToolExplorer({ tool, onViewSource, onClose }) {
   const [selectedIndex, setSelectedIndex] = useState5(0);
@@ -2226,21 +2359,21 @@ function ToolExplorer({ tool, onViewSource, onClose }) {
       result.push({
         type: "skill",
         name: skill.name,
-        path: join8(toolDir, tool.name, "skills", skill.name, "SKILL.md")
+        path: join9(toolDir, tool.name, "skills", skill.name, "SKILL.md")
       });
     }
     for (const cmd of tool.includes.commands) {
       result.push({
         type: "command",
         name: `/${cmd}`,
-        path: join8(toolDir, tool.name, "commands", `${cmd}.md`)
+        path: join9(toolDir, tool.name, "commands", `${cmd}.md`)
       });
     }
     for (const agent of tool.includes.agents) {
       result.push({
         type: "agent",
         name: agent,
-        path: join8(toolDir, tool.name, "agents", agent, "AGENT.md")
+        path: join9(toolDir, tool.name, "agents", agent, "AGENT.md")
       });
     }
     return result;
@@ -2258,12 +2391,12 @@ function ToolExplorer({ tool, onViewSource, onClose }) {
     }
     if (key.return && items.length > 0) {
       const item = items[selectedIndex];
-      if (existsSync6(item.path)) {
+      if (existsSync7(item.path)) {
         const content = readFileSync7(item.path, "utf-8");
         onViewSource(`${tool.name} / ${item.name}`, content);
       } else {
         const yamlPath = item.path.replace(".md", ".yaml");
-        if (existsSync6(yamlPath)) {
+        if (existsSync7(yamlPath)) {
           const content = readFileSync7(yamlPath, "utf-8");
           onViewSource(`${tool.name} / ${item.name}`, content);
         }