@orderful/droid 0.52.1 → 0.53.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @orderful/droid
 
+## 0.53.0
+
+### Minor Changes
+
+- [#325](https://github.com/Orderful/droid/pull/325) [`241a9ac`](https://github.com/Orderful/droid/commit/241a9acbfb9864c634fe9f858e19b594d80e83f9) Thanks [@frytyler](https://github.com/frytyler)! - Export tools + pack functions from package entry point and add `droid copy-skills` command for agents integration
+
+### Patch Changes
+
+- [#323](https://github.com/Orderful/droid/pull/323) [`f1459be`](https://github.com/Orderful/droid/commit/f1459beecb6aa72c5fcc6ee552308a3d39f52aad) Thanks [@frytyler](https://github.com/frytyler)! - Add `planSummary` field to propose-plan evidence schema
+
 ## 0.52.1
 
 ### Patch Changes

package/dist/bin/droid.js

@@ -2,7 +2,7 @@
 
 // src/bin/droid.ts
 import { program } from "commander";
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 
 // src/commands/setup.ts
 import inquirer from "inquirer";
@@ -1410,6 +1410,39 @@ function findSkillPath(skillName) {
   }
   return null;
 }
+function getSkillPath(skillName) {
+  const result = findSkillPath(skillName);
+  return result?.skillDir ?? null;
+}
+function copySkillsToDir(skillNames, dest) {
+  if (!existsSync7(dest)) {
+    mkdirSync5(dest, { recursive: true });
+  }
+  const results = [];
+  for (const name of skillNames) {
+    const skillDir = getSkillPath(name);
+    if (!skillDir) {
+      results.push({
+        name,
+        success: false,
+        error: `Skill '${name}' not found in bundled tools`
+      });
+      continue;
+    }
+    const targetDir = join8(dest, name);
+    try {
+      copyDirectoryRecursive(skillDir, targetDir, () => true);
+      results.push({ name, success: true, dest: targetDir });
+    } catch (err) {
+      results.push({
+        name,
+        success: false,
+        error: `Failed to copy: ${err}`
+      });
+    }
+  }
+  return results;
+}
 function getBundledSkills() {
   if (!existsSync7(BUNDLED_SKILLS_DIR)) {
     return [];
@@ -6101,6 +6134,52 @@ async function slackPostCommand(options) {
   }
 }
 
+// src/commands/copy-skills.ts
+import chalk13 from "chalk";
+import { readFileSync as readFileSync13 } from "fs";
+function copySkillsCommand(options) {
+  const { dest, manifest, names } = options;
+  let skillNames;
+  if (manifest) {
+    try {
+      const content = readFileSync13(manifest, "utf-8");
+      skillNames = JSON.parse(content);
+      if (!Array.isArray(skillNames)) {
+        console.error(
+          chalk13.red("Manifest must be a JSON array of skill names")
+        );
+        process.exit(1);
+      }
+    } catch (err) {
+      console.error(chalk13.red(`Failed to read manifest: ${err}`));
+      process.exit(1);
+    }
+  } else if (names?.length) {
+    skillNames = names;
+  } else {
+    console.error(
+      chalk13.red("Provide either --manifest <file> or --names <names...>")
+    );
+    process.exit(1);
+  }
+  if (skillNames.length === 0) {
+    console.log(chalk13.yellow("No skills to copy."));
+    return;
+  }
+  const results = copySkillsToDir(skillNames, dest);
+  for (const result of results) {
+    if (result.success) {
+      console.log(chalk13.green(`  \u2713 ${result.name} \u2192 ${result.dest}`));
+    } else {
+      console.error(chalk13.red(`  \u2717 ${result.name}: ${result.error}`));
+    }
+  }
+  const failed = results.filter((r) => !r.success);
+  if (failed.length > 0) {
+    process.exit(1);
+  }
+}
+
 // src/bin/droid.ts
 var version = getVersion();
 program.name("droid").description("Droid, teaching your AI new tricks").version(version);
@@ -6121,6 +6200,7 @@ program.command("update").description("Update droid and installed tools").option
 program.command("tui").description("Launch interactive TUI dashboard").action(tuiCommand);
 program.command("pack").description("Create zip packs for distribution").argument("[audience]", "Target audience (e.g., engineering, customer-support)").option("-l, --list", "List available audiences and tool counts").option("-t, --tool <name>", "Pack a single tool by name").option("-o, --output <dir>", "Output directory (default: cwd)").action(packCommand);
 program.command("exec <tool> <script>").description("Execute a tool script").argument("[args...]", "Arguments to pass to the script").allowUnknownOption().action(execCommand);
+program.command("copy-skills").description("Copy bundled skills to a destination directory").requiredOption("-d, --dest <dir>", "Destination directory").option("-m, --manifest <file>", "JSON file with array of skill names").option("-n, --names <names...>", "Skill names to copy").action(copySkillsCommand);
 var integrations = program.command("integrations").description("Manage external service integrations");
 var integrationsSetup = integrations.command("setup").description("Set up an integration");
 integrationsSetup.command("slack").description("Set up Slack integration").action(integrationsSetupSlackCommand);
@@ -6132,8 +6212,8 @@ if (configExists()) {
   const config = loadConfig();
   const newPlatforms = syncNewPlatforms(config);
   if (newPlatforms.length > 0) {
-    console.log(chalk13.green(`\u2713 Detected new platform(s): ${newPlatforms.join(", ")}`));
-    console.log(chalk13.gray("  Synced installed tools to new platform(s)\n"));
+    console.log(chalk14.green(`\u2713 Detected new platform(s): ${newPlatforms.join(", ")}`));
+    console.log(chalk14.gray("  Synced installed tools to new platform(s)\n"));
     saveConfig(config);
   }
 }

package/dist/commands/copy-skills.d.ts

@@ -0,0 +1,15 @@
+interface CopySkillsOptions {
+    dest: string;
+    manifest?: string;
+    names?: string[];
+}
+/**
+ * Copy bundled skills to a destination directory.
+ *
+ * Usage:
+ *   droid copy-skills -d dist/assets/skills -m droid-skills.json
+ *   droid copy-skills -d dist/assets/skills -n propose-plan edi-schema
+ */
+export declare function copySkillsCommand(options: CopySkillsOptions): void;
+export {};
+//# sourceMappingURL=copy-skills.d.ts.map

package/dist/commands/copy-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-skills.d.ts","sourceRoot":"","sources":["../../src/commands/copy-skills.ts"],"names":[],"mappings":"AAIA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAgDlE"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from './lib/types';
 export * from './lib/config';
 export * from './lib/skills';
+export * from './lib/tools';
+export * from './lib/pack';
 export * from './lib/version';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -602,6 +602,9 @@ async function checkForUpdates() {
 // src/lib/tools.ts
 var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
 var BUNDLED_TOOLS_DIR = join5(__dirname2, "../tools");
+function getBundledToolsDir() {
+  return BUNDLED_TOOLS_DIR;
+}
 function loadToolManifest(toolDir) {
   const manifestPath = join5(toolDir, "TOOL.yaml");
   if (!existsSync4(manifestPath)) {
@@ -645,6 +648,58 @@ function isToolInstalled(toolName) {
   const requiredSkills = tool.includes.skills.filter((s) => s.required).map((s) => s.name);
   return requiredSkills.some((skillName) => skillName in installedTools);
 }
+function getInstalledToolVersion(toolName) {
+  const config = loadConfig();
+  const installedTools = getPlatformTools(config);
+  const tool = getBundledTools().find((t) => t.name === toolName);
+  if (!tool) return null;
+  const requiredSkills = tool.includes.skills.filter((s) => s.required).map((s) => s.name);
+  for (const skillName of requiredSkills) {
+    if (installedTools[skillName]) {
+      return installedTools[skillName].version;
+    }
+  }
+  return null;
+}
+function getToolUpdateStatus(toolName) {
+  const installedVersion = getInstalledToolVersion(toolName);
+  const tool = getBundledTools().find((t) => t.name === toolName);
+  const bundledVersion = tool?.version || null;
+  if (!installedVersion || !bundledVersion) {
+    return {
+      name: toolName,
+      hasUpdate: false,
+      installedVersion,
+      bundledVersion
+    };
+  }
+  const hasUpdate = compareSemver(bundledVersion, installedVersion) > 0;
+  return {
+    name: toolName,
+    hasUpdate,
+    installedVersion,
+    bundledVersion
+  };
+}
+function getToolsWithUpdates() {
+  const config = loadConfig();
+  const installedTools = getPlatformTools(config);
+  const bundledTools = getBundledTools();
+  const toolsWithUpdates = [];
+  for (const tool of bundledTools) {
+    const requiredSkills = tool.includes.skills.filter((s) => s.required).map((s) => s.name);
+    const isInstalled = requiredSkills.some(
+      (skillName) => skillName in installedTools
+    );
+    if (isInstalled) {
+      const updateStatus = getToolUpdateStatus(tool.name);
+      if (updateStatus.hasUpdate) {
+        toolsWithUpdates.push(updateStatus);
+      }
+    }
+  }
+  return toolsWithUpdates;
+}
 
 // src/lib/agents.ts
 var __dirname3 = dirname4(fileURLToPath3(import.meta.url));
@@ -1316,6 +1371,39 @@ function findSkillPath(skillName) {
   }
   return null;
 }
+function getSkillPath(skillName) {
+  const result = findSkillPath(skillName);
+  return result?.skillDir ?? null;
+}
+function copySkillsToDir(skillNames, dest) {
+  if (!existsSync7(dest)) {
+    mkdirSync5(dest, { recursive: true });
+  }
+  const results = [];
+  for (const name of skillNames) {
+    const skillDir = getSkillPath(name);
+    if (!skillDir) {
+      results.push({
+        name,
+        success: false,
+        error: `Skill '${name}' not found in bundled tools`
+      });
+      continue;
+    }
+    const targetDir = join8(dest, name);
+    try {
+      copyDirectoryRecursive(skillDir, targetDir, () => true);
+      results.push({ name, success: true, dest: targetDir });
+    } catch (err) {
+      results.push({
+        name,
+        success: false,
+        error: `Failed to copy: ${err}`
+      });
+    }
+  }
+  return results;
+}
 function getBundledSkills() {
   if (!existsSync7(BUNDLED_SKILLS_DIR)) {
     return [];
@@ -1822,6 +1910,239 @@ function uninstallCommand(commandName, skillName) {
   }
   return { success: false, message: `Command not installed: ${commandName}` };
 }
+
+// src/lib/pack.ts
+import { existsSync as existsSync8, readdirSync as readdirSync7, readFileSync as readFileSync7, createWriteStream } from "fs";
+import { join as join9 } from "path";
+import archiver from "archiver";
+function getToolsForAudience(audience) {
+  const allTools = getBundledTools();
+  return allTools.filter((tool) => {
+    if (!tool.audience || tool.audience.length === 0) {
+      return false;
+    }
+    return tool.audience.includes(audience) || tool.audience.includes("all" /* All */);
+  });
+}
+function getAudienceInfo() {
+  const allTools = getBundledTools();
+  const audiences = Object.values(ToolAudience).filter(
+    (a) => a !== "all" /* All */
+  );
+  return audiences.map((audience) => {
+    const tools = allTools.filter(
+      (tool) => tool.audience && (tool.audience.includes(audience) || tool.audience.includes("all" /* All */))
+    );
+    return {
+      audience,
+      toolCount: tools.length,
+      toolNames: tools.map((t) => t.name)
+    };
+  }).filter((info) => info.toolCount > 0);
+}
+function collectToolArtifacts(tool) {
+  const artifacts = [];
+  const toolDir = join9(getBundledToolsDir(), tool.name);
+  for (const skill of tool.includes.skills) {
+    const skillDir = join9(toolDir, "skills", skill.name);
+    if (!existsSync8(skillDir)) continue;
+    const skillMd = join9(skillDir, "SKILL.md");
+    if (existsSync8(skillMd)) {
+      artifacts.push({
+        sourcePath: skillMd,
+        zipPath: `skills/${skill.name}/SKILL.md`
+      });
+    }
+    const refsDir = join9(skillDir, "references");
+    if (existsSync8(refsDir)) {
+      const refFiles = readdirSync7(refsDir).filter((f) => !f.startsWith("."));
+      for (const file of refFiles) {
+        artifacts.push({
+          sourcePath: join9(refsDir, file),
+          zipPath: `skills/${skill.name}/references/${file}`
+        });
+      }
+    }
+  }
+  const commandsDir = join9(toolDir, "commands");
+  if (existsSync8(commandsDir)) {
+    const commandFiles = readdirSync7(commandsDir).filter(
+      (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
+    );
+    for (const file of commandFiles) {
+      artifacts.push({
+        sourcePath: join9(commandsDir, file),
+        zipPath: `commands/${file}`
+      });
+    }
+  }
+  const agentsDir = join9(toolDir, "agents");
+  if (existsSync8(agentsDir)) {
+    const agentFiles = readdirSync7(agentsDir).filter(
+      (f) => f.endsWith(".md") && f.toLowerCase() !== "readme.md"
+    );
+    for (const file of agentFiles) {
+      artifacts.push({
+        sourcePath: join9(agentsDir, file),
+        zipPath: `agents/${file}`
+      });
+    }
+  }
+  return artifacts;
+}
+function generateClaudeMd(tools) {
+  const skillNames = [];
+  for (const tool of tools) {
+    for (const skill of tool.includes.skills) {
+      skillNames.push(skill.name);
+    }
+  }
+  const lines = [
+    "# Droid Skills",
+    "",
+    "Skills installed from a Droid pack. Each skill teaches your AI new capabilities.",
+    ""
+  ];
+  for (const name of skillNames) {
+    lines.push(`- [${name}](skills/${name}/SKILL.md)`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function generateReadme(label, tools) {
+  const lines = [
+    `# Droid Pack: ${label}`,
+    "",
+    "This pack contains AI skills, commands, and agents for Claude Desktop.",
+    "",
+    "## Installation",
+    "",
+    "1. Unzip this archive",
+    "2. Copy the contents into your `~/.claude/` directory:",
+    "",
+    "```bash",
+    "# From the directory where you unzipped:",
+    "cp -r skills/ ~/.claude/skills/",
+    "cp -r commands/ ~/.claude/commands/",
+    "cp -r agents/ ~/.claude/agents/",
+    "```",
+    "",
+    "3. Append the contents of `CLAUDE.md` to your `~/.claude/CLAUDE.md`:",
+    "",
+    "```bash",
+    "cat CLAUDE.md >> ~/.claude/CLAUDE.md",
+    "```",
+    "",
+    "## Included Tools",
+    ""
+  ];
+  for (const tool of tools) {
+    lines.push(`- **${tool.name}** (v${tool.version}) \u2014 ${tool.description}`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function checkDependencies(tools) {
+  const warnings = [];
+  const toolNames = new Set(tools.map((t) => t.name));
+  for (const tool of tools) {
+    if (!tool.dependencies) continue;
+    for (const dep of tool.dependencies) {
+      if (!toolNames.has(dep)) {
+        warnings.push(
+          `Tool '${tool.name}' depends on '${dep}' which is not included in this pack`
+        );
+      }
+    }
+  }
+  return warnings;
+}
+async function buildToolPack(options) {
+  const { toolName, outputDir } = options;
+  const allTools = getBundledTools();
+  const tool = allTools.find((t) => t.name === toolName);
+  if (!tool) {
+    return {
+      success: false,
+      message: `Tool '${toolName}' not found`
+    };
+  }
+  const tools = [tool];
+  const warnings = checkDependencies(tools);
+  const filename = `droid-${toolName}.zip`;
+  const outputPath = join9(outputDir, filename);
+  return new Promise((resolve) => {
+    const output = createWriteStream(outputPath);
+    const archive = archiver("zip", { zlib: { level: 9 } });
+    output.on("close", () => {
+      resolve({
+        success: true,
+        message: `Pack created: ${filename}`,
+        outputPath,
+        toolCount: 1,
+        warnings: warnings.length > 0 ? warnings : void 0
+      });
+    });
+    archive.on("error", (err) => {
+      resolve({
+        success: false,
+        message: `Failed to create pack: ${err.message}`
+      });
+    });
+    archive.pipe(output);
+    const artifacts = collectToolArtifacts(tool);
+    for (const artifact of artifacts) {
+      const content = readFileSync7(artifact.sourcePath, "utf-8");
+      archive.append(content, { name: artifact.zipPath });
+    }
+    archive.append(generateClaudeMd(tools), { name: "CLAUDE.md" });
+    archive.append(generateReadme(toolName, tools), { name: "README.md" });
+    archive.finalize();
+  });
+}
+async function buildPack(options) {
+  const { audience, outputDir } = options;
+  const tools = getToolsForAudience(audience);
+  if (tools.length === 0) {
+    return {
+      success: false,
+      message: `No tools found for audience '${audience}'`
+    };
+  }
+  const warnings = checkDependencies(tools);
+  const filename = `droid-${audience}-pack.zip`;
+  const outputPath = join9(outputDir, filename);
+  return new Promise((resolve) => {
+    const output = createWriteStream(outputPath);
+    const archive = archiver("zip", { zlib: { level: 9 } });
+    output.on("close", () => {
+      resolve({
+        success: true,
+        message: `Pack created: ${filename}`,
+        outputPath,
+        toolCount: tools.length,
+        warnings: warnings.length > 0 ? warnings : void 0
+      });
+    });
+    archive.on("error", (err) => {
+      resolve({
+        success: false,
+        message: `Failed to create pack: ${err.message}`
+      });
+    });
+    archive.pipe(output);
+    for (const tool of tools) {
+      const artifacts = collectToolArtifacts(tool);
+      for (const artifact of artifacts) {
+        const content = readFileSync7(artifact.sourcePath, "utf-8");
+        archive.append(content, { name: artifact.zipPath });
+      }
+    }
+    archive.append(generateClaudeMd(tools), { name: "CLAUDE.md" });
+    archive.append(generateReadme(audience, tools), { name: "README.md" });
+    archive.finalize();
+  });
+}
 export {
   AIToolValue as AITool,
   BuiltInOutput,
@@ -1830,20 +2151,27 @@ export {
   SkillStatus,
   ToolAudience,
   addRepo,
+  buildPack,
+  buildToolPack,
   checkForUpdates,
   compareSemver,
   configExists,
+  copySkillsToDir,
   ensureConfigDir,
   findSkillPath,
   getAITag,
+  getAudienceInfo,
   getAutoUpdateConfig,
   getBundledSkills,
   getBundledSkillsDir,
+  getBundledTools,
+  getBundledToolsDir,
   getCommandsInstallPath,
   getConfigDir,
   getConfigPath,
   getConfigValue,
   getInstalledSkill,
+  getInstalledToolVersion,
   getPlatformConfigPath,
   getPlatformTools,
   getPlatformToolsFor,
@@ -1851,20 +2179,26 @@ export {
   getRepoPath,
   getRepos,
   getSkillOverridesPath,
+  getSkillPath,
   getSkillStatusDisplay,
   getSkillUpdateStatus,
   getSkillsInstallPath,
   getSkillsWithUpdates,
   getToolSettings,
+  getToolUpdateStatus,
+  getToolsForAudience,
+  getToolsWithUpdates,
   getUpdateInfo,
   getVersion,
   installCommand,
   installSkill,
   isCommandInstalled,
   isSkillInstalled,
+  isToolInstalled,
   loadConfig,
   loadSkillManifest,
   loadSkillOverrides,
+  loadToolManifest,
   removeRepo,
   runUpdate,
   saveConfig,

package/dist/lib/skills.d.ts

@@ -34,6 +34,29 @@ export declare function findSkillPath(skillName: string): {
     toolDir: string;
     skillDir: string;
 } | null;
+/**
+ * Resolve the absolute path to a bundled skill directory by name.
+ * Returns null if the skill is not found.
+ *
+ * This is the stable public API for consumers who need to locate skill
+ * assets (e.g., for copying into a build output). It encapsulates droid's
+ * internal `tools/{tool}/skills/{name}/` directory structure.
+ */
+export declare function getSkillPath(skillName: string): string | null;
+/**
+ * Copy bundled skills to a destination directory.
+ * Each skill is copied as `{dest}/{skillName}/` with SKILL.md, references/, etc.
+ *
+ * @param skillNames - Array of skill names to copy
+ * @param dest - Target directory (created if it doesn't exist)
+ * @returns Results per skill: success/failure with paths
+ */
+export declare function copySkillsToDir(skillNames: string[], dest: string): Array<{
+    name: string;
+    success: boolean;
+    dest?: string;
+    error?: string;
+}>;
 /**
  * Get all bundled skills from all tools
  */

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

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}

package/dist/tools/propose-plan/skills/propose-plan/SKILL.md

@@ -32,6 +32,7 @@ Produce a single JSON object matching the schema in `references/output-schema.js
   "name": "string — short human-readable plan name (optional)",
   "category": "string — grouping category, e.g. org-provisioning (optional)",
   "evidence": {
+    "planSummary": "string — one-line plain-language summary, e.g. 'Provision org and billing for Acme Corp' (optional)",
     "reasoning": "string — your analysis of what needs to happen and why",
     "sourceSummary": "string — concise summary of what you found during research",
     "sourceRaw": "string — JSON-stringified raw source data from research (optional)",
@@ -53,9 +54,10 @@ Produce a single JSON object matching the schema in `references/output-schema.js
 
 ### Evidence Fields
 
-| Field           | Purpose                                                                                                 | Reviewer Experience                                          |
-| --------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| `reasoning`     | Your analysis — what needs to happen and why. Cite actual data from your research, not assumptions.     | First thing they read. Establishes trust.                    |
+| Field           | Purpose                                                                                                       | Reviewer Experience                                          |
+| --------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `planSummary`   | Optional. One-line plain-language summary of the plan. Keep it short and specific — entity names, not jargon. | Shown in headers and card previews. Quick scan context.      |
+| `reasoning`     | Your analysis — what needs to happen and why. Cite actual data from your research, not assumptions.           | First thing they read. Establishes trust.                    |
 | `sourceSummary` | Concise summary of what you found. Include entity names, IDs, and states.                               | Quick scan to verify you looked at the right things.         |
 | `sourceRaw`     | Optional. JSON-stringified raw API responses or data snapshots.                                         | Expandable detail for reviewers who want to verify.          |
 | `impactSummary` | What changes if the plan is approved. Be specific — "creates org X with ISA ID Y" not "creates an org". | The core decision point. Reviewer approves based on this.    |
@@ -129,6 +131,7 @@ Say you've been asked to provision an Orderful org for a new customer. You've qu
 ```json
 {
   "evidence": {
+    "planSummary": "Provision org, billing, and welcome email for Acme Corp",
     "reasoning": "Salesforce account Acme Corp (SF-001234) was signed on 2026-03-01 and has no Orderful OrgID. No existing Orderful org matches by name or ISA ID. The account's primary contact is jane@acme.com. ISA ID derived from Customer_ISA_ID__c field: ACME001.",
     "sourceSummary": "Salesforce: Acme Corp (SF-001234), signed 2026-03-01, no OrgID. Orderful: no org named 'Acme Corp', no ISA ID 'ACME001' in use.",
     "sourceRaw": "{\"salesforce_account\":{\"Id\":\"SF-001234\",\"Name\":\"Acme Corp\",\"OrgID__c\":null,\"Customer_ISA_ID__c\":\"ACME001\"},\"orderful_org_search\":{\"results\":[]}}",

package/dist/tools/propose-plan/skills/propose-plan/references/output-schema.json

@@ -18,6 +18,10 @@
       "description": "Research findings and rationale supporting the plan",
       "required": ["reasoning", "sourceSummary", "impactSummary"],
       "properties": {
+        "planSummary": {
+          "type": "string",
+          "description": "One-line plain-language summary of the plan"
+        },
         "reasoning": {
           "type": "string",
           "description": "Analysis of what needs to happen and why"

package/package.json

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

package/src/bin/droid.ts

@@ -21,6 +21,7 @@ import { integrationsSetupSlackCommand, integrationsStatusCommand, slackPostComm
 import { getVersion } from '../lib/version';
 import { loadConfig, saveConfig, configExists } from '../lib/config';
 import { syncNewPlatforms } from '../lib/platforms';
+import { copySkillsCommand } from '../commands/copy-skills';
 
 const version = getVersion();
 
@@ -120,6 +121,14 @@ program
   .allowUnknownOption()
   .action(execCommand);
 
+program
+  .command('copy-skills')
+  .description('Copy bundled skills to a destination directory')
+  .requiredOption('-d, --dest <dir>', 'Destination directory')
+  .option('-m, --manifest <file>', 'JSON file with array of skill names')
+  .option('-n, --names <names...>', 'Skill names to copy')
+  .action(copySkillsCommand);
+
 // Integrations command with subcommands
 const integrations = program
   .command('integrations')

package/src/commands/copy-skills.ts

@@ -0,0 +1,66 @@
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { copySkillsToDir } from '../lib/skills';
+
+interface CopySkillsOptions {
+  dest: string;
+  manifest?: string;
+  names?: string[];
+}
+
+/**
+ * Copy bundled skills to a destination directory.
+ *
+ * Usage:
+ *   droid copy-skills -d dist/assets/skills -m droid-skills.json
+ *   droid copy-skills -d dist/assets/skills -n propose-plan edi-schema
+ */
+export function copySkillsCommand(options: CopySkillsOptions): void {
+  const { dest, manifest, names } = options;
+
+  // Resolve skill names from manifest file or --names flag
+  let skillNames: string[];
+
+  if (manifest) {
+    try {
+      const content = readFileSync(manifest, 'utf-8');
+      skillNames = JSON.parse(content);
+      if (!Array.isArray(skillNames)) {
+        console.error(
+          chalk.red('Manifest must be a JSON array of skill names'),
+        );
+        process.exit(1);
+      }
+    } catch (err) {
+      console.error(chalk.red(`Failed to read manifest: ${err}`));
+      process.exit(1);
+    }
+  } else if (names?.length) {
+    skillNames = names;
+  } else {
+    console.error(
+      chalk.red('Provide either --manifest <file> or --names <names...>'),
+    );
+    process.exit(1);
+  }
+
+  if (skillNames.length === 0) {
+    console.log(chalk.yellow('No skills to copy.'));
+    return;
+  }
+
+  const results = copySkillsToDir(skillNames, dest);
+
+  for (const result of results) {
+    if (result.success) {
+      console.log(chalk.green(`  ✓ ${result.name} → ${result.dest}`));
+    } else {
+      console.error(chalk.red(`  ✗ ${result.name}: ${result.error}`));
+    }
+  }
+
+  const failed = results.filter((r) => !r.success);
+  if (failed.length > 0) {
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -2,4 +2,6 @@
 export * from './lib/types';
 export * from './lib/config';
 export * from './lib/skills';
+export * from './lib/tools';
+export * from './lib/pack';
 export * from './lib/version';

package/src/lib/skills.ts

@@ -213,6 +213,69 @@ export function findSkillPath(
   return null;
 }
 
+/**
+ * Resolve the absolute path to a bundled skill directory by name.
+ * Returns null if the skill is not found.
+ *
+ * This is the stable public API for consumers who need to locate skill
+ * assets (e.g., for copying into a build output). It encapsulates droid's
+ * internal `tools/{tool}/skills/{name}/` directory structure.
+ */
+export function getSkillPath(skillName: string): string | null {
+  const result = findSkillPath(skillName);
+  return result?.skillDir ?? null;
+}
+
+/**
+ * Copy bundled skills to a destination directory.
+ * Each skill is copied as `{dest}/{skillName}/` with SKILL.md, references/, etc.
+ *
+ * @param skillNames - Array of skill names to copy
+ * @param dest - Target directory (created if it doesn't exist)
+ * @returns Results per skill: success/failure with paths
+ */
+export function copySkillsToDir(
+  skillNames: string[],
+  dest: string,
+): Array<{ name: string; success: boolean; dest?: string; error?: string }> {
+  if (!existsSync(dest)) {
+    mkdirSync(dest, { recursive: true });
+  }
+
+  const results: Array<{
+    name: string;
+    success: boolean;
+    dest?: string;
+    error?: string;
+  }> = [];
+
+  for (const name of skillNames) {
+    const skillDir = getSkillPath(name);
+    if (!skillDir) {
+      results.push({
+        name,
+        success: false,
+        error: `Skill '${name}' not found in bundled tools`,
+      });
+      continue;
+    }
+
+    const targetDir = join(dest, name);
+    try {
+      copyDirectoryRecursive(skillDir, targetDir, () => true);
+      results.push({ name, success: true, dest: targetDir });
+    } catch (err) {
+      results.push({
+        name,
+        success: false,
+        error: `Failed to copy: ${err}`,
+      });
+    }
+  }
+
+  return results;
+}
+
 /**
  * Get all bundled skills from all tools
  */

package/src/tools/propose-plan/skills/propose-plan/SKILL.md

@@ -32,6 +32,7 @@ Produce a single JSON object matching the schema in `references/output-schema.js
   "name": "string — short human-readable plan name (optional)",
   "category": "string — grouping category, e.g. org-provisioning (optional)",
   "evidence": {
+    "planSummary": "string — one-line plain-language summary, e.g. 'Provision org and billing for Acme Corp' (optional)",
     "reasoning": "string — your analysis of what needs to happen and why",
     "sourceSummary": "string — concise summary of what you found during research",
     "sourceRaw": "string — JSON-stringified raw source data from research (optional)",
@@ -53,9 +54,10 @@ Produce a single JSON object matching the schema in `references/output-schema.js
 
 ### Evidence Fields
 
-| Field           | Purpose                                                                                                 | Reviewer Experience                                          |
-| --------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| `reasoning`     | Your analysis — what needs to happen and why. Cite actual data from your research, not assumptions.     | First thing they read. Establishes trust.                    |
+| Field           | Purpose                                                                                                       | Reviewer Experience                                          |
+| --------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `planSummary`   | Optional. One-line plain-language summary of the plan. Keep it short and specific — entity names, not jargon. | Shown in headers and card previews. Quick scan context.      |
+| `reasoning`     | Your analysis — what needs to happen and why. Cite actual data from your research, not assumptions.           | First thing they read. Establishes trust.                    |
 | `sourceSummary` | Concise summary of what you found. Include entity names, IDs, and states.                               | Quick scan to verify you looked at the right things.         |
 | `sourceRaw`     | Optional. JSON-stringified raw API responses or data snapshots.                                         | Expandable detail for reviewers who want to verify.          |
 | `impactSummary` | What changes if the plan is approved. Be specific — "creates org X with ISA ID Y" not "creates an org". | The core decision point. Reviewer approves based on this.    |
@@ -129,6 +131,7 @@ Say you've been asked to provision an Orderful org for a new customer. You've qu
 ```json
 {
   "evidence": {
+    "planSummary": "Provision org, billing, and welcome email for Acme Corp",
     "reasoning": "Salesforce account Acme Corp (SF-001234) was signed on 2026-03-01 and has no Orderful OrgID. No existing Orderful org matches by name or ISA ID. The account's primary contact is jane@acme.com. ISA ID derived from Customer_ISA_ID__c field: ACME001.",
     "sourceSummary": "Salesforce: Acme Corp (SF-001234), signed 2026-03-01, no OrgID. Orderful: no org named 'Acme Corp', no ISA ID 'ACME001' in use.",
     "sourceRaw": "{\"salesforce_account\":{\"Id\":\"SF-001234\",\"Name\":\"Acme Corp\",\"OrgID__c\":null,\"Customer_ISA_ID__c\":\"ACME001\"},\"orderful_org_search\":{\"results\":[]}}",

package/src/tools/propose-plan/skills/propose-plan/references/output-schema.json

@@ -18,6 +18,10 @@
       "description": "Research findings and rationale supporting the plan",
       "required": ["reasoning", "sourceSummary", "impactSummary"],
       "properties": {
+        "planSummary": {
+          "type": "string",
+          "description": "One-line plain-language summary of the plan"
+        },
         "reasoning": {
           "type": "string",
           "description": "Analysis of what needs to happen and why"