Give bots skills: runbooks they load when a job matches

A skill is a runbook: a name, a unique slug, a one-line description of when
it applies, and the markdown body. A run only ever sees the slug and
description (one load_skill tool carries them), and reads the whole body
only when it calls the tool, so a long runbook costs nothing until needed.

Skills are the third extension kind beside MCP servers and custom tools, on
the same botExtensionsSql path, so per-bot, per-workspace and all-bots
grants work the same way, and attachDefaultExtensions hands an every-bot
skill to new bots. load_skill is a reserved tool name, so a custom tool
cannot shadow it, and a built-in wins a clash.

Managed on Settings > Skills; ExtensionRow links each kind to its own page
and a skill never reports a failure, since nothing connects or runs.

src/bots-queue/run-bot-reply.ts

@@ -18,6 +18,7 @@ import runTextLoop from "@/src/harness/text/run-text-loop";
 import grabBotChatTools from "@/src/harness/tools/bot/grab-bot-chat-tools";
 import grabBotFileTools from "@/src/harness/tools/storage/grab-bot-file-tools";
 import openBotExtensions from "@/src/harness/tools/extensions/open-bot-extensions";
+import openBotSkills from "@/src/harness/tools/skills/open-bot-skills";
 import botMessagesToHarness from "./bot-messages-to-harness";
 import composeComputersNote from "./compose-computers-note";
 import grabSessionCarryOver from "./grab-session-carry-over";
@@ -112,6 +113,14 @@ export default async function runBotReply({
         signal,
     });
 
+    /**
+     * The run's skills: one `load_skill` tool and the lines that name them.
+     */
+    const skills = openBotSkills({
+        skills: extensions.skills,
+        taken: [...tools, ...extensions.tools].map((tool) => tool.name),
+    });
+
     /**
      * delegate_task is only there while the coordinator has workers.
      */
@@ -140,6 +149,7 @@ export default async function runBotReply({
                     in_workspace: Boolean(workspace_id),
                 }),
                 crew_note,
+                skills.note,
                 extensions.note,
                 `Now: ${new Date().toUTCString()}.`,
             ]
@@ -153,7 +163,7 @@ export default async function runBotReply({
                     user_id,
                 }),
             }),
-            tools: [...tools, ...file_tools, ...extensions.tools],
+            tools: [...tools, ...file_tools, ...extensions.tools, ...skills.tools],
             max_steps: AppData.BotReplyMaxToolSteps,
             bot_id: bot.id,
             workspace_id,

src/bots-queue/run-bot-task.ts

@@ -14,6 +14,7 @@ import grabUserWorkspaces from "@/src/functions/backend/db/workspaces/grab-user-
 import runTextLoop from "@/src/harness/text/run-text-loop";
 import openComputerTools from "@/src/harness/tools/computer/open-computer-tools";
 import openBotExtensions, { type OpenBotExtensions } from "@/src/harness/tools/extensions/open-bot-extensions";
+import openBotSkills, { type OpenBotSkills } from "@/src/harness/tools/skills/open-bot-skills";
 import grabBotTools from "@/src/harness/tools/bot/grab-bot-tools";
 import createWorkspaceTool from "@/src/harness/tools/bot/create-workspace-tool";
 import updateWorkspaceTool from "@/src/harness/tools/bot/update-workspace-tool";
@@ -71,6 +72,7 @@ export default async function runBotTask({
         : null;
 
     let extensions: OpenBotExtensions | undefined;
+    let skills: OpenBotSkills | undefined;
 
     try {
         const session_id = await jobSessionId({ job });
@@ -173,6 +175,11 @@ export default async function runBotTask({
             signal,
         });
 
+        skills = openBotSkills({
+            skills: extensions.skills,
+            taken: [...tools, ...extensions.tools].map((tool) => tool.name),
+        });
+
         const result = await runTextLoop({
             system: [
                 prompt,
@@ -200,6 +207,7 @@ export default async function runBotTask({
                           .map((env) => `- ${env.key}${env.description ? `: ${env.description}` : ""}`)
                           .join("\n")}`
                     : "",
+                skills.note,
                 extensions.note,
             ]
                 .filter(Boolean)
@@ -214,7 +222,7 @@ export default async function runBotTask({
                     }),
                 },
             ],
-            tools: [...tools, ...extensions.tools],
+            tools: [...tools, ...extensions.tools, ...skills.tools],
             bot_id: bot.id,
             workspace_id,
             signal,