opencode-swarm-plugin 0.12.23 → 0.12.25

package/bin/swarm.ts

@@ -623,6 +623,66 @@ async function doctor() {
   const requiredMissing = required.filter((r) => !r.available);
   const optionalMissing = optional.filter((r) => !r.available);
 
+  // Check skills
+  p.log.step("Skills:");
+  const configDir = join(homedir(), ".config", "opencode");
+  const globalSkillsPath = join(configDir, "skills");
+  const bundledSkillsPath = join(__dirname, "..", "global-skills");
+
+  // Global skills directory
+  if (existsSync(globalSkillsPath)) {
+    try {
+      const { readdirSync } = require("fs");
+      const skills = readdirSync(globalSkillsPath, { withFileTypes: true })
+        .filter((d: { isDirectory: () => boolean }) => d.isDirectory())
+        .map((d: { name: string }) => d.name);
+      if (skills.length > 0) {
+        p.log.success(`Global skills (${skills.length}): ${skills.join(", ")}`);
+      } else {
+        p.log.warn("Global skills directory exists but is empty");
+      }
+    } catch {
+      p.log.warn("Global skills directory: " + globalSkillsPath);
+    }
+  } else {
+    p.log.warn("No global skills directory (run 'swarm setup' to create)");
+  }
+
+  // Bundled skills
+  if (existsSync(bundledSkillsPath)) {
+    try {
+      const { readdirSync } = require("fs");
+      const bundled = readdirSync(bundledSkillsPath, { withFileTypes: true })
+        .filter((d: { isDirectory: () => boolean }) => d.isDirectory())
+        .map((d: { name: string }) => d.name);
+      p.log.success(
+        `Bundled skills (${bundled.length}): ${bundled.join(", ")}`,
+      );
+    } catch {
+      p.log.warn("Could not read bundled skills");
+    }
+  }
+
+  // Project skills (check current directory)
+  const projectSkillsDirs = [".opencode/skills", ".claude/skills", "skills"];
+  for (const dir of projectSkillsDirs) {
+    if (existsSync(dir)) {
+      try {
+        const { readdirSync } = require("fs");
+        const skills = readdirSync(dir, { withFileTypes: true })
+          .filter((d: { isDirectory: () => boolean }) => d.isDirectory())
+          .map((d: { name: string }) => d.name);
+        if (skills.length > 0) {
+          p.log.success(
+            `Project skills in ${dir}/ (${skills.length}): ${skills.join(", ")}`,
+          );
+        }
+      } catch {
+        // Ignore
+      }
+    }
+  }
+
   if (requiredMissing.length > 0) {
     p.outro(
       "Missing " +
@@ -977,7 +1037,8 @@ async function setup() {
   p.log.step("Setting up OpenCode integration...");
 
   // Create directories if needed
-  for (const dir of [pluginDir, commandDir, agentDir]) {
+  const skillsDir = join(configDir, "skills");
+  for (const dir of [pluginDir, commandDir, agentDir, skillsDir]) {
     if (!existsSync(dir)) {
       mkdirSync(dir, { recursive: true });
     }
@@ -995,8 +1056,24 @@ async function setup() {
   writeFileSync(workerAgentPath, getWorkerAgent(workerModel as string));
   p.log.success("Worker agent: " + workerAgentPath);
 
+  p.log.success("Skills directory: " + skillsDir);
+
+  // Show bundled skills info
+  const bundledSkillsPath = join(__dirname, "..", "global-skills");
+  if (existsSync(bundledSkillsPath)) {
+    try {
+      const { readdirSync } = require("fs");
+      const bundled = readdirSync(bundledSkillsPath, { withFileTypes: true })
+        .filter((d: { isDirectory: () => boolean }) => d.isDirectory())
+        .map((d: { name: string }) => d.name);
+      p.log.message(dim("  Bundled skills: " + bundled.join(", ")));
+    } catch {
+      // Ignore
+    }
+  }
+
   p.note(
-    'cd your-project\nbd init\nopencode\n/swarm "your task"',
+    'cd your-project\nbd init\nopencode\n/swarm "your task"\n\nSkills: Use skills_list to see available skills',
     "Next steps",
   );
 
@@ -1078,6 +1155,25 @@ async function init() {
       }
     }
 
+    // Offer to create project skills directory
+    const createSkillsDir = await p.confirm({
+      message: "Create project skills directory (.opencode/skills/)?",
+      initialValue: false,
+    });
+
+    if (!p.isCancel(createSkillsDir) && createSkillsDir) {
+      const skillsPath = ".opencode/skills";
+      if (!existsSync(skillsPath)) {
+        mkdirSync(skillsPath, { recursive: true });
+        p.log.success("Created " + skillsPath + "/");
+        p.log.message(
+          dim("  Add SKILL.md files here for project-specific skills"),
+        );
+      } else {
+        p.log.warn(skillsPath + "/ already exists");
+      }
+    }
+
     p.outro("Project initialized! Use '/swarm' in OpenCode to get started.");
   } else {
     s.stop("Failed to initialize beads");

package/examples/plugin-wrapper-template.ts

@@ -666,6 +666,115 @@ const swarm_evaluation_prompt = tool({
   execute: (args, ctx) => execTool("swarm_evaluation_prompt", args, ctx),
 });
 
+// =============================================================================
+// Skills Tools
+// =============================================================================
+
+const skills_list = tool({
+  description:
+    "List all available skills from global, project, and bundled sources",
+  args: {
+    source: tool.schema
+      .enum(["all", "global", "project", "bundled"])
+      .optional()
+      .describe("Filter by source (default: all)"),
+  },
+  execute: (args, ctx) => execTool("skills_list", args, ctx),
+});
+
+const skills_read = tool({
+  description: "Read a skill's full content including SKILL.md and references",
+  args: {
+    name: tool.schema.string().describe("Skill name"),
+  },
+  execute: (args, ctx) => execTool("skills_read", args, ctx),
+});
+
+const skills_use = tool({
+  description:
+    "Get skill content formatted for injection into agent context. Use this when you need to apply a skill's knowledge to the current task.",
+  args: {
+    name: tool.schema.string().describe("Skill name"),
+    context: tool.schema
+      .string()
+      .optional()
+      .describe("Optional context about how the skill will be used"),
+  },
+  execute: (args, ctx) => execTool("skills_use", args, ctx),
+});
+
+const skills_create = tool({
+  description: "Create a new skill with SKILL.md template",
+  args: {
+    name: tool.schema.string().describe("Skill name (kebab-case)"),
+    description: tool.schema.string().describe("Brief skill description"),
+    scope: tool.schema
+      .enum(["global", "project"])
+      .optional()
+      .describe("Where to create (default: project)"),
+    tags: tool.schema
+      .array(tool.schema.string())
+      .optional()
+      .describe("Skill tags for discovery"),
+  },
+  execute: (args, ctx) => execTool("skills_create", args, ctx),
+});
+
+const skills_update = tool({
+  description: "Update an existing skill's SKILL.md content",
+  args: {
+    name: tool.schema.string().describe("Skill name"),
+    content: tool.schema.string().describe("New SKILL.md content"),
+  },
+  execute: (args, ctx) => execTool("skills_update", args, ctx),
+});
+
+const skills_delete = tool({
+  description: "Delete a skill (project skills only)",
+  args: {
+    name: tool.schema.string().describe("Skill name"),
+  },
+  execute: (args, ctx) => execTool("skills_delete", args, ctx),
+});
+
+const skills_init = tool({
+  description: "Initialize skills directory in current project",
+  args: {
+    path: tool.schema
+      .string()
+      .optional()
+      .describe("Custom path (default: .opencode/skills)"),
+  },
+  execute: (args, ctx) => execTool("skills_init", args, ctx),
+});
+
+const skills_add_script = tool({
+  description: "Add an executable script to a skill",
+  args: {
+    skill_name: tool.schema.string().describe("Skill name"),
+    script_name: tool.schema.string().describe("Script filename"),
+    content: tool.schema.string().describe("Script content"),
+    executable: tool.schema
+      .boolean()
+      .optional()
+      .describe("Make executable (default: true)"),
+  },
+  execute: (args, ctx) => execTool("skills_add_script", args, ctx),
+});
+
+const skills_execute = tool({
+  description: "Execute a skill's script",
+  args: {
+    skill_name: tool.schema.string().describe("Skill name"),
+    script_name: tool.schema.string().describe("Script to execute"),
+    args: tool.schema
+      .array(tool.schema.string())
+      .optional()
+      .describe("Script arguments"),
+  },
+  execute: (args, ctx) => execTool("skills_execute", args, ctx),
+});
+
 // =============================================================================
 // Plugin Export
 // =============================================================================
@@ -716,6 +825,16 @@ export const SwarmPlugin: Plugin = async (
       swarm_spawn_subtask,
       swarm_complete_subtask,
       swarm_evaluation_prompt,
+      // Skills
+      skills_list,
+      skills_read,
+      skills_use,
+      skills_create,
+      skills_update,
+      skills_delete,
+      skills_init,
+      skills_add_script,
+      skills_execute,
     },
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.12.23",
+  "version": "0.12.25",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "dist/index.js",