@orderful/droid 0.29.2 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @orderful/droid
 
+## 0.30.0
+
+### Minor Changes
+
+- [#178](https://github.com/Orderful/droid/pull/178) [`77bc5f2`](https://github.com/Orderful/droid/commit/77bc5f24f4340a123cfe9648da134d68895ffefd) Thanks [@frytyler](https://github.com/frytyler)! - Unify skills installation to ~/.claude/skills/ for all platforms. This is the Agent Skills standard location supported by Claude Code, OpenCode, and Cursor. Existing OpenCode skills are automatically migrated to the unified location.
+
 ## 0.29.2
 
 ### Patch Changes

package/dist/bin/droid.js

@@ -200,15 +200,16 @@ import YAML3 from "yaml";
 // src/lib/platforms.ts
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
+var UNIFIED_SKILLS_PATH = join2(homedir2(), ".claude", "skills");
 var PLATFORM_PATHS = {
   ["claude-code" /* ClaudeCode */]: {
-    skills: join2(homedir2(), ".claude", "skills"),
+    skills: UNIFIED_SKILLS_PATH,
     commands: join2(homedir2(), ".claude", "commands"),
     agents: join2(homedir2(), ".claude", "agents"),
     config: join2(homedir2(), ".claude", "CLAUDE.md")
   },
   ["opencode" /* OpenCode */]: {
-    skills: join2(homedir2(), ".config", "opencode", "skill"),
+    skills: UNIFIED_SKILLS_PATH,
     commands: join2(homedir2(), ".config", "opencode", "command"),
     agents: join2(homedir2(), ".config", "opencode", "agent"),
     config: join2(homedir2(), ".config", "opencode", "AGENTS.md")
@@ -774,6 +775,56 @@ function createOpenCodePluginCleanupMigration(version2) {
     }
   };
 }
+function createUnifiedSkillsPathMigration(version2) {
+  return {
+    version: version2,
+    description: "Copy OpenCode skills to unified ~/.claude/skills/ location",
+    up: () => {
+      const oldOpenCodeSkillsPath = join6(
+        homedir3(),
+        ".config",
+        "opencode",
+        "skill"
+      );
+      const unifiedSkillsPath = join6(homedir3(), ".claude", "skills");
+      if (!existsSync4(oldOpenCodeSkillsPath)) {
+        return;
+      }
+      if (!existsSync4(unifiedSkillsPath)) {
+        mkdirSync3(unifiedSkillsPath, { recursive: true });
+      }
+      const skillDirs = readdirSync3(oldOpenCodeSkillsPath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+      for (const skillName of skillDirs) {
+        const sourcePath = join6(oldOpenCodeSkillsPath, skillName);
+        const destPath = join6(unifiedSkillsPath, skillName);
+        if (existsSync4(destPath)) {
+          continue;
+        }
+        try {
+          copyDirRecursive(sourcePath, destPath);
+        } catch (error) {
+          console.warn(
+            `Warning: Could not copy skill ${skillName} to unified location: ${error}`
+          );
+        }
+      }
+    }
+  };
+}
+function copyDirRecursive(src, dest) {
+  mkdirSync3(dest, { recursive: true });
+  const entries = readdirSync3(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join6(src, entry.name);
+    const destPath = join6(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      const content = readFileSync5(srcPath);
+      writeFileSync3(destPath, content);
+    }
+  }
+}
 var PACKAGE_MIGRATIONS = [
   createPlatformSyncMigration("0.25.0"),
   createConfigSkillNameMigration("0.27.2"),
@@ -781,7 +832,8 @@ var PACKAGE_MIGRATIONS = [
   createClaudeCodeCommandCleanupMigration("0.28.0"),
   // Retry: 0.28.0 migration had platform check that prevented running after platform switch
   createClaudeCodeCommandCleanupMigration("0.28.1"),
-  createOpenCodePluginCleanupMigration("0.29.2")
+  createOpenCodePluginCleanupMigration("0.29.2"),
+  createUnifiedSkillsPathMigration("0.30.0")
 ];
 var TOOL_MIGRATIONS = {
   brain: [createConfigDirMigration("droid-brain", "0.2.3")],
@@ -1523,7 +1575,7 @@ async function setupCommand() {
       console.log(chalk2.gray("  Droid permissions already configured in Claude Code"));
     }
   } else if (answers.platform === "opencode" /* OpenCode */) {
-    console.log(chalk2.gray("  OpenCode has native skills support - no configuration needed"));
+    console.log(chalk2.gray("  Skills installed to ~/.claude/skills/ (works with Claude Code, OpenCode, and Cursor)"));
   }
   console.log(chalk2.gray("\nRun `droid skills` to browse and install skills."));
 }

package/dist/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAA0D,MAAM,cAAc,CAAC;AA6ChG;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgE7H;AAyBD,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAwGlD"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAA0D,MAAM,cAAc,CAAC;AA6ChG;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAiE7H;AAyBD,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAwGlD"}

package/dist/index.js

@@ -208,15 +208,16 @@ import YAML3 from "yaml";
 // src/lib/platforms.ts
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
+var UNIFIED_SKILLS_PATH = join2(homedir2(), ".claude", "skills");
 var PLATFORM_PATHS = {
   ["claude-code" /* ClaudeCode */]: {
-    skills: join2(homedir2(), ".claude", "skills"),
+    skills: UNIFIED_SKILLS_PATH,
     commands: join2(homedir2(), ".claude", "commands"),
     agents: join2(homedir2(), ".claude", "agents"),
     config: join2(homedir2(), ".claude", "CLAUDE.md")
   },
   ["opencode" /* OpenCode */]: {
-    skills: join2(homedir2(), ".config", "opencode", "skill"),
+    skills: UNIFIED_SKILLS_PATH,
     commands: join2(homedir2(), ".config", "opencode", "command"),
     agents: join2(homedir2(), ".config", "opencode", "agent"),
     config: join2(homedir2(), ".config", "opencode", "AGENTS.md")
@@ -747,6 +748,56 @@ function createOpenCodePluginCleanupMigration(version) {
     }
   };
 }
+function createUnifiedSkillsPathMigration(version) {
+  return {
+    version,
+    description: "Copy OpenCode skills to unified ~/.claude/skills/ location",
+    up: () => {
+      const oldOpenCodeSkillsPath = join6(
+        homedir3(),
+        ".config",
+        "opencode",
+        "skill"
+      );
+      const unifiedSkillsPath = join6(homedir3(), ".claude", "skills");
+      if (!existsSync4(oldOpenCodeSkillsPath)) {
+        return;
+      }
+      if (!existsSync4(unifiedSkillsPath)) {
+        mkdirSync3(unifiedSkillsPath, { recursive: true });
+      }
+      const skillDirs = readdirSync3(oldOpenCodeSkillsPath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+      for (const skillName of skillDirs) {
+        const sourcePath = join6(oldOpenCodeSkillsPath, skillName);
+        const destPath = join6(unifiedSkillsPath, skillName);
+        if (existsSync4(destPath)) {
+          continue;
+        }
+        try {
+          copyDirRecursive(sourcePath, destPath);
+        } catch (error) {
+          console.warn(
+            `Warning: Could not copy skill ${skillName} to unified location: ${error}`
+          );
+        }
+      }
+    }
+  };
+}
+function copyDirRecursive(src, dest) {
+  mkdirSync3(dest, { recursive: true });
+  const entries = readdirSync3(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join6(src, entry.name);
+    const destPath = join6(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      const content = readFileSync5(srcPath);
+      writeFileSync3(destPath, content);
+    }
+  }
+}
 var PACKAGE_MIGRATIONS = [
   createPlatformSyncMigration("0.25.0"),
   createConfigSkillNameMigration("0.27.2"),
@@ -754,7 +805,8 @@ var PACKAGE_MIGRATIONS = [
   createClaudeCodeCommandCleanupMigration("0.28.0"),
   // Retry: 0.28.0 migration had platform check that prevented running after platform switch
   createClaudeCodeCommandCleanupMigration("0.28.1"),
-  createOpenCodePluginCleanupMigration("0.29.2")
+  createOpenCodePluginCleanupMigration("0.29.2"),
+  createUnifiedSkillsPathMigration("0.30.0")
 ];
 var TOOL_MIGRATIONS = {
   brain: [createConfigDirMigration("droid-brain", "0.2.3")],

package/dist/lib/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/lib/migrations.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,SAAS,CAAC;AA2ajB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA2CtC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAStC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAyDA"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/lib/migrations.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,SAAS,CAAC;AA8fjB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA2CtC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAStC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAyDA"}

package/dist/lib/platforms.d.ts

@@ -2,6 +2,9 @@ import { Platform } from './types';
 /**
  * Platform-specific paths configuration
  * Single source of truth for all platform-specific directories
+ *
+ * Note: Skills are unified to ~/.claude/skills/ (all platforms read this location).
+ * Commands and agents remain platform-specific as there's no cross-platform compatibility.
  */
 export declare const PLATFORM_PATHS: {
     readonly "claude-code": {

package/dist/lib/platforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../../src/lib/platforms.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD"}
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../../src/lib/platforms.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQnC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orderful/droid",
-  "version": "0.29.2",
+  "version": "0.30.0",
   "description": "AI workflow toolkit for sharing skills, commands, and agents across the team",
   "type": "module",
   "bin": {

package/src/commands/setup.ts

@@ -107,8 +107,9 @@ export function configurePlatformPermissions(platform: Platform): { added: strin
   }
 
   if (platform === Platform.OpenCode) {
-    // OpenCode now has native skills support - no configuration needed
-    // Ensure config directory exists for when skills are installed
+    // Skills are installed to ~/.claude/skills/ (unified location)
+    // OpenCode reads from this location via Agent Skills standard compatibility
+    // Ensure config directory exists for commands and agents
     const globalConfigDir = join(homedir(), '.config', 'opencode');
     if (!existsSync(globalConfigDir)) {
       mkdirSync(globalConfigDir, { recursive: true });
@@ -243,7 +244,7 @@ export async function setupCommand(): Promise<void> {
       console.log(chalk.gray('  Droid permissions already configured in Claude Code'));
     }
   } else if (answers.platform === Platform.OpenCode) {
-    console.log(chalk.gray('  OpenCode has native skills support - no configuration needed'));
+    console.log(chalk.gray('  Skills installed to ~/.claude/skills/ (works with Claude Code, OpenCode, and Cursor)'));
   }
 
   console.log(chalk.gray('\nRun `droid skills` to browse and install skills.'));

package/src/lib/migrations.ts

@@ -409,6 +409,88 @@ function createOpenCodePluginCleanupMigration(version: string): Migration {
   };
 }
 
+/**
+ * Migration: Copy OpenCode skills to unified ~/.claude/skills/ location
+ *
+ * All platforms now read skills from ~/.claude/skills/ (Agent Skills standard).
+ * This migration copies existing OpenCode skills to the unified location.
+ *
+ * Strategy:
+ * - Additive only: copies skills, never deletes from source
+ * - Skip if exists: if skill already in ~/.claude/skills/, don't overwrite
+ */
+function createUnifiedSkillsPathMigration(version: string): Migration {
+  return {
+    version,
+    description: 'Copy OpenCode skills to unified ~/.claude/skills/ location',
+    up: () => {
+      const oldOpenCodeSkillsPath = join(
+        homedir(),
+        '.config',
+        'opencode',
+        'skill',
+      );
+      const unifiedSkillsPath = join(homedir(), '.claude', 'skills');
+
+      // Skip if old OpenCode skills directory doesn't exist
+      if (!existsSync(oldOpenCodeSkillsPath)) {
+        return;
+      }
+
+      // Ensure unified skills directory exists
+      if (!existsSync(unifiedSkillsPath)) {
+        mkdirSync(unifiedSkillsPath, { recursive: true });
+      }
+
+      // Get all skill directories from old location
+      const skillDirs = readdirSync(oldOpenCodeSkillsPath, { withFileTypes: true })
+        .filter((dirent) => dirent.isDirectory())
+        .map((dirent) => dirent.name);
+
+      for (const skillName of skillDirs) {
+        const sourcePath = join(oldOpenCodeSkillsPath, skillName);
+        const destPath = join(unifiedSkillsPath, skillName);
+
+        // Skip if already exists in unified location (Claude version wins)
+        if (existsSync(destPath)) {
+          continue;
+        }
+
+        // Copy skill directory recursively
+        try {
+          copyDirRecursive(sourcePath, destPath);
+        } catch (error) {
+          // Non-fatal: Log warning but continue with other skills
+          console.warn(
+            `Warning: Could not copy skill ${skillName} to unified location: ${error}`,
+          );
+        }
+      }
+    },
+  };
+}
+
+/**
+ * Recursively copy a directory
+ */
+function copyDirRecursive(src: string, dest: string): void {
+  mkdirSync(dest, { recursive: true });
+
+  const entries = readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      const content = readFileSync(srcPath);
+      writeFileSync(destPath, content);
+    }
+  }
+}
+
 /**
  * Registry of package-level migrations
  * These run when the @orderful/droid npm package updates
@@ -423,6 +505,7 @@ const PACKAGE_MIGRATIONS: Migration[] = [
   // Retry: 0.28.0 migration had platform check that prevented running after platform switch
   createClaudeCodeCommandCleanupMigration('0.28.1'),
   createOpenCodePluginCleanupMigration('0.29.2'),
+  createUnifiedSkillsPathMigration('0.30.0'),
 ];
 
 /**

package/src/lib/platforms.ts

@@ -2,19 +2,28 @@ import { join } from 'path';
 import { homedir } from 'os';
 import { Platform } from './types';
 
+/**
+ * Unified skills path - all platforms read from ~/.claude/skills/
+ * This is the Agent Skills standard location supported by Claude Code, OpenCode, and Cursor.
+ */
+const UNIFIED_SKILLS_PATH = join(homedir(), '.claude', 'skills');
+
 /**
  * Platform-specific paths configuration
  * Single source of truth for all platform-specific directories
+ *
+ * Note: Skills are unified to ~/.claude/skills/ (all platforms read this location).
+ * Commands and agents remain platform-specific as there's no cross-platform compatibility.
  */
 export const PLATFORM_PATHS = {
   [Platform.ClaudeCode]: {
-    skills: join(homedir(), '.claude', 'skills'),
+    skills: UNIFIED_SKILLS_PATH,
     commands: join(homedir(), '.claude', 'commands'),
     agents: join(homedir(), '.claude', 'agents'),
     config: join(homedir(), '.claude', 'CLAUDE.md'),
   },
   [Platform.OpenCode]: {
-    skills: join(homedir(), '.config', 'opencode', 'skill'),
+    skills: UNIFIED_SKILLS_PATH,
     commands: join(homedir(), '.config', 'opencode', 'command'),
     agents: join(homedir(), '.config', 'opencode', 'agent'),
     config: join(homedir(), '.config', 'opencode', 'AGENTS.md'),

package/src/lib/skills.test.ts

@@ -42,9 +42,10 @@ describe("getSkillsInstallPath", () => {
     expect(path).toBe(join(homedir(), ".claude", "skills"));
   });
 
-  it("should return OpenCode path", () => {
+  it("should return unified skills path for OpenCode", () => {
+    // OpenCode now uses the unified ~/.claude/skills/ path (Agent Skills standard)
     const path = getSkillsInstallPath(Platform.OpenCode);
-    expect(path).toBe(join(homedir(), ".config", "opencode", "skill"));
+    expect(path).toBe(join(homedir(), ".claude", "skills"));
   });
 });