@cmdop/bot 2026.2.28 → 2026.3.101

package/README.md

@@ -1,6 +1,6 @@
 # @cmdop/bot
 
-Multi-channel bot framework for [CMDOP](https://cmdop.com) — run `/exec`, `/agent`, and `/files` commands from Telegram, Discord, and Slack.
+Multi-channel bot framework for [CMDOP](https://cmdop.com) — run `/exec`, `/agent`, `/skills`, and `/files` commands from Telegram, Discord, and Slack.
 
 ```
 pnpm add @cmdop/bot
@@ -19,7 +19,7 @@ await hub.addTelegram({ token: process.env.TELEGRAM_TOKEN });
 await hub.start();
 ```
 
-That's it. Your bot now responds to `/exec`, `/agent`, `/files`, and `/help`.
+That's it. Your bot now responds to `/exec`, `/agent`, `/skills`, `/files`, and `/help`.
 
 ---
 
@@ -76,6 +76,7 @@ Requires Socket Mode enabled in your Slack app settings. See [examples/slack.ts]
 |---------|-------|-------------------|
 | `/exec` | `/exec <shell command>` | `EXECUTE` |
 | `/agent` | `/agent <prompt>` | `EXECUTE` |
+| `/skills` | `/skills list \| show <name> \| run <name> <prompt>` | `EXECUTE` |
 | `/files` | `/files [read] <path>` | `READ` |
 | `/help` | `/help` | none |
 
@@ -102,7 +103,7 @@ Permission levels (ordered, each includes all levels below):
 |-------|--------|
 | `NONE` | No commands (only `/help`) |
 | `READ` | `/files` |
-| `EXECUTE` | `/exec`, `/agent` |
+| `EXECUTE` | `/exec`, `/agent`, `/skills` |
 | `FILES` | _(reserved for future write operations)_ |
 | `ADMIN` | All commands |
 
@@ -282,7 +283,7 @@ All errors extend `BotError` and expose a `code` string:
 ## Links
 
 - [Homepage](https://cmdop.com/sdk/python/bot)
-- [Documentation](https://cmdop.com/docs/sdk/node/bot)
+- [Documentation](https://cmdop.com/docs/sdk/node-bot)
 - [npm](https://www.npmjs.com/package/@cmdop/bot)
 
 ## License

package/dist/index.cjs

@@ -16356,7 +16356,7 @@ var init_channel3 = __esm({
                 { title: "Get help", message: "/help" }
               ]
             });
-            await say("Hello! Use `/exec`, `/agent`, `/files`, or `/help`.");
+            await say("Hello! Use `/exec`, `/agent`, `/skills`, `/files`, or `/help`.");
           },
           threadContextChanged: async ({ saveThreadContext }) => {
             await saveThreadContext();
@@ -16888,6 +16888,103 @@ ${lines.join("\n\n")}`;
   }
 };
 
+// src/handlers/skills.ts
+init_errors();
+var SkillsHandler = class extends BaseHandler {
+  name = "skills";
+  description = "List, show, or run skills on the remote machine";
+  usage = "/skills list | /skills show <name> | /skills run <name> <prompt>";
+  requiredPermission = "EXECUTE";
+  maxOutput;
+  constructor(client, logger, config = {}) {
+    super(client, logger);
+    this.maxOutput = config.maxOutputLength ?? 4e3;
+  }
+  async handle(ctx) {
+    const subcommand = ctx.args[0]?.toLowerCase();
+    if (!subcommand) {
+      return err(new exports.CommandArgsError("skills", "Subcommand required. Usage: /skills list | /skills show <name> | /skills run <name> <prompt>"));
+    }
+    try {
+      if (ctx.machine) {
+        await this.client.skills.setMachine(ctx.machine);
+      }
+      switch (subcommand) {
+        case "list":
+          return await this.handleList();
+        case "show":
+          return await this.handleShow(ctx);
+        case "run":
+          return await this.handleRun(ctx);
+        default:
+          return err(new exports.CommandArgsError("skills", `Unknown subcommand "${subcommand}". Usage: /skills list | /skills show <name> | /skills run <name> <prompt>`));
+      }
+    } catch (e3) {
+      const errMsg = e3 instanceof Error ? e3.message : String(e3);
+      this.logger.error("Skills operation failed", { error: errMsg });
+      if (errMsg.includes("session_id") || errMsg.includes("No active session")) {
+        return err(new exports.CMDOPError("Machine is offline or CMDOP agent is not running.\nhttps://cmdop.com/downloads/"));
+      }
+      if (errMsg.includes("DEADLINE_EXCEEDED") || errMsg.includes("timeout")) {
+        return err(new exports.CMDOPError("Request timed out. The skill may be too complex \u2014 try a simpler prompt."));
+      }
+      if (errMsg.includes("UNAVAILABLE") || errMsg.includes("Connection refused")) {
+        return err(new exports.CMDOPError("Server unavailable. Check your connection and try again."));
+      }
+      return err(new exports.CMDOPError(`Skills error: ${errMsg}`, e3 instanceof Error ? e3 : void 0));
+    }
+  }
+  async handleList() {
+    const skills = await this.client.skills.list();
+    if (skills.length === 0) {
+      return ok({ type: "text", text: "No skills installed." });
+    }
+    const lines = skills.map(
+      (s4) => s4.description ? `${s4.name} \u2014 ${s4.description}` : s4.name
+    );
+    return ok({ type: "text", text: lines.join("\n") });
+  }
+  async handleShow(ctx) {
+    const name = ctx.args[1];
+    if (!name) {
+      return err(new exports.CommandArgsError("skills", "Skill name required. Usage: /skills show <name>"));
+    }
+    const detail = await this.client.skills.show(name);
+    if (!detail.found) {
+      return err(new exports.CMDOPError(detail.error ?? `Skill "${name}" not found`));
+    }
+    const parts = [];
+    if (detail.info) {
+      parts.push(`Skill: ${detail.info.name}`);
+      if (detail.info.description) parts.push(`Description: ${detail.info.description}`);
+      if (detail.info.author) parts.push(`Author: ${detail.info.author}`);
+      if (detail.info.version) parts.push(`Version: ${detail.info.version}`);
+      if (detail.info.origin) parts.push(`Origin: ${detail.info.origin}`);
+    }
+    if (detail.source) parts.push(`Source: ${detail.source}`);
+    if (detail.content) {
+      const preview = detail.content.length > this.maxOutput ? detail.content.slice(0, this.maxOutput) + "\n...(truncated)" : detail.content;
+      parts.push(`
+System prompt:
+${preview}`);
+    }
+    return ok({ type: "code", code: parts.join("\n") });
+  }
+  async handleRun(ctx) {
+    const name = ctx.args[1];
+    if (!name) {
+      return err(new exports.CommandArgsError("skills", "Skill name and prompt required. Usage: /skills run <name> <prompt>"));
+    }
+    const prompt = ctx.args.slice(2).join(" ").trim();
+    if (!prompt) {
+      return err(new exports.CommandArgsError("skills", "Prompt required. Usage: /skills run <name> <prompt>"));
+    }
+    const result = await this.client.skills.run(name, prompt);
+    const code = result.text.length > this.maxOutput ? result.text.slice(0, this.maxOutput) + "\n...(truncated)" : result.text;
+    return ok({ type: "code", code });
+  }
+};
+
 // src/config.ts
 init_errors();
 var BotSettingsSchema = v4.z.object({
@@ -17007,6 +17104,7 @@ var IntegrationHub = class _IntegrationHub {
     const hub = new _IntegrationHub(client, logger, settings2, permissions, dispatcher, mode);
     hub.registerHandler(new TerminalHandler(client, logger, { maxOutputLength: settings2.maxOutputLength }));
     hub.registerHandler(new AgentHandler(client, logger, { maxOutputLength: settings2.maxOutputLength }));
+    hub.registerHandler(new SkillsHandler(client, logger, { maxOutputLength: settings2.maxOutputLength }));
     hub.registerHandler(new FilesHandler(client, logger));
     hub.registerHandler(new HelpHandler(client, logger, {
       getCommands: () => dispatcher.getCommandList()