thoth-plugin 1.1.0 → 1.1.1

package/dist/index.js

@@ -405,7 +405,92 @@ Before stating any fact about Zeus's life:
 - *If NOT FOUND*: Say "I don't have that recorded" \u2014 never guess
 </Knowledge_Management>`;
 // src/specialization/prompt-builder.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2, readdirSync } from "fs";
+import { join as join3 } from "path";
+import { homedir } from "os";
+function parseSkillTriggers(content) {
+  const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---/;
+  const match = content.match(frontmatterRegex);
+  if (!match)
+    return null;
+  const yaml = match[1];
+  let name = "";
+  const triggers = [];
+  let inTriggers = false;
+  for (const line of yaml.split(`
+`)) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("name:")) {
+      name = trimmed.slice(5).trim();
+      inTriggers = false;
+    } else if (trimmed === "triggers:") {
+      inTriggers = true;
+    } else if (inTriggers && trimmed.startsWith("- ")) {
+      triggers.push(trimmed.slice(2).trim());
+    } else if (trimmed.includes(":") && !trimmed.startsWith("-")) {
+      inTriggers = false;
+    }
+  }
+  return triggers.length > 0 ? { name, triggers } : null;
+}
+function discoverTriggersFromDir(skillsDir) {
+  if (!existsSync3(skillsDir))
+    return [];
+  const results = [];
+  try {
+    const entries = readdirSync(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith("."))
+        continue;
+      if (!entry.isDirectory())
+        continue;
+      const skillMdPath = join3(skillsDir, entry.name, "SKILL.md");
+      if (!existsSync3(skillMdPath))
+        continue;
+      try {
+        const content = readFileSync2(skillMdPath, "utf-8");
+        const parsed = parseSkillTriggers(content);
+        if (parsed) {
+          results.push(parsed);
+        }
+      } catch {}
+    }
+  } catch {}
+  return results;
+}
+function buildSkillRoutingSection() {
+  const projectSkillsDir = join3(process.cwd(), ".opencode", "skill");
+  const userSkillsDir = join3(homedir(), ".opencode", "skill");
+  const projectTriggers = discoverTriggersFromDir(projectSkillsDir);
+  const userTriggers = discoverTriggersFromDir(userSkillsDir);
+  const seen = new Set;
+  const allTriggers = [];
+  for (const t of [...projectTriggers, ...userTriggers]) {
+    if (!seen.has(t.name)) {
+      seen.add(t.name);
+      allTriggers.push(t);
+    }
+  }
+  if (allTriggers.length === 0) {
+    return "";
+  }
+  const lines = [
+    "<Skill_Routing>",
+    "## Skill Routing (CHECK BEFORE RESPONDING)",
+    "",
+    "Before responding to user requests, check if their intent matches a skill trigger:",
+    ""
+  ];
+  for (const skill of allTriggers) {
+    const triggers = skill.triggers.map((t) => `"${t}"`).join(", ");
+    lines.push(`- ${triggers} \u2192 \`skill({ skill: "${skill.name}" })\``);
+  }
+  lines.push("");
+  lines.push("**Rule**: If user intent matches a trigger, invoke the skill immediately. Don't improvise workflows that already exist.");
+  lines.push("</Skill_Routing>");
+  return lines.join(`
+`);
+}
 var THOTH_CORE_CAPABILITIES = `<Core_Capabilities>
 ## Core Capabilities
 
@@ -539,6 +624,10 @@ function buildThothPrompt(spec) {
   sections.push(THOTH_ANTI_PATTERNS);
   sections.push(THOTH_BEHAVIORAL_GUIDANCE);
   sections.push(THOTH_KNOWLEDGE_MANAGEMENT);
+  const skillRouting = buildSkillRoutingSection();
+  if (skillRouting) {
+    sections.push(skillRouting);
+  }
   sections.push(THOTH_CORE_CAPABILITIES);
   sections.push(THOTH_EXECUTION);
   sections.push(THOTH_PERMISSIONS);
@@ -3238,7 +3327,7 @@ To proceed, mark this as Emergency/P0 or wait until work hours.`
 }
 // src/hooks/directory-agents-injector/index.ts
 import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
-import { dirname as dirname4, join as join8, resolve } from "path";
+import { dirname as dirname4, join as join9, resolve } from "path";
 
 // src/hooks/directory-agents-injector/storage.ts
 import {
@@ -3248,18 +3337,18 @@ import {
   writeFileSync as writeFileSync3,
   unlinkSync
 } from "fs";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 
 // src/hooks/directory-agents-injector/constants.ts
-import { join as join6 } from "path";
-var xdgData = process.env.XDG_DATA_HOME || join6(process.env.HOME || "", ".local", "share");
-var OPENCODE_STORAGE = join6(xdgData, "opencode", "storage");
-var AGENTS_INJECTOR_STORAGE = join6(OPENCODE_STORAGE, "thoth-directory-agents");
+import { join as join7 } from "path";
+var xdgData = process.env.XDG_DATA_HOME || join7(process.env.HOME || "", ".local", "share");
+var OPENCODE_STORAGE = join7(xdgData, "opencode", "storage");
+var AGENTS_INJECTOR_STORAGE = join7(OPENCODE_STORAGE, "thoth-directory-agents");
 var AGENTS_FILENAME2 = "AGENTS.md";
 
 // src/hooks/directory-agents-injector/storage.ts
 function getStoragePath(sessionID) {
-  return join7(AGENTS_INJECTOR_STORAGE, `${sessionID}.json`);
+  return join8(AGENTS_INJECTOR_STORAGE, `${sessionID}.json`);
 }
 function loadInjectedPaths(sessionID) {
   const filePath = getStoragePath(sessionID);
@@ -3315,7 +3404,7 @@ function createDirectoryAgentsInjectorHook(options) {
     let current = startDir;
     const normalizedBase = knowledgeBasePath.endsWith("/") ? knowledgeBasePath.slice(0, -1) : knowledgeBasePath;
     while (true) {
-      const agentsPath = join8(current, AGENTS_FILENAME2);
+      const agentsPath = join9(current, AGENTS_FILENAME2);
       if (existsSync6(agentsPath)) {
         found.push(agentsPath);
       }
@@ -3396,8 +3485,8 @@ ${content}`;
 }
 
 // src/shared-hooks/todo-continuation-enforcer.ts
-import { existsSync as existsSync8, readdirSync as readdirSync2 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync8, readdirSync as readdirSync3 } from "fs";
+import { join as join13 } from "path";
 
 // src/shared-hooks/utils/session-state.ts
 var subagentSessions = new Set;
@@ -3410,16 +3499,16 @@ function getMainSessionID() {
 }
 
 // src/shared-hooks/utils/message-storage.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync7, readdirSync, writeFileSync as writeFileSync4 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync7, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "fs";
+import { join as join11 } from "path";
 
 // src/shared-hooks/utils/constants.ts
-import { join as join9 } from "path";
-import { homedir as homedir2 } from "os";
-var xdgData2 = process.env.XDG_DATA_HOME || join9(homedir2(), ".local", "share");
-var OPENCODE_STORAGE2 = join9(xdgData2, "opencode", "storage");
-var MESSAGE_STORAGE = join9(OPENCODE_STORAGE2, "message");
-var PART_STORAGE = join9(OPENCODE_STORAGE2, "part");
+import { join as join10 } from "path";
+import { homedir as homedir3 } from "os";
+var xdgData2 = process.env.XDG_DATA_HOME || join10(homedir3(), ".local", "share");
+var OPENCODE_STORAGE2 = join10(xdgData2, "opencode", "storage");
+var MESSAGE_STORAGE = join10(OPENCODE_STORAGE2, "message");
+var PART_STORAGE = join10(OPENCODE_STORAGE2, "part");
 var THINKING_TYPES = new Set(["thinking", "redacted_thinking", "reasoning"]);
 var META_TYPES = new Set(["step-start", "step-finish"]);
 var CONTENT_TYPES = new Set(["text", "tool", "tool_use", "tool_result"]);
@@ -3427,10 +3516,10 @@ var CONTENT_TYPES = new Set(["text", "tool", "tool_use", "tool_result"]);
 // src/shared-hooks/utils/message-storage.ts
 function findNearestMessageWithFields(messageDir) {
   try {
-    const files = readdirSync(messageDir).filter((f) => f.endsWith(".json")).sort().reverse();
+    const files = readdirSync2(messageDir).filter((f) => f.endsWith(".json")).sort().reverse();
     for (const file of files) {
       try {
-        const content = readFileSync7(join10(messageDir, file), "utf-8");
+        const content = readFileSync7(join11(messageDir, file), "utf-8");
         const msg = JSON.parse(content);
         if (msg.agent && msg.model?.providerID && msg.model?.modelID) {
           return msg;
@@ -3471,11 +3560,11 @@ Incomplete tasks remain in your todo list. Continue working on the next pending
 function getMessageDir(sessionID) {
   if (!existsSync8(MESSAGE_STORAGE))
     return null;
-  const directPath = join12(MESSAGE_STORAGE, sessionID);
+  const directPath = join13(MESSAGE_STORAGE, sessionID);
   if (existsSync8(directPath))
     return directPath;
-  for (const dir of readdirSync2(MESSAGE_STORAGE)) {
-    const sessionPath = join12(MESSAGE_STORAGE, dir, sessionID);
+  for (const dir of readdirSync3(MESSAGE_STORAGE)) {
+    const sessionPath = join13(MESSAGE_STORAGE, dir, sessionID);
     if (existsSync8(sessionPath))
       return sessionPath;
   }
@@ -3703,16 +3792,16 @@ function createTodoContinuationEnforcer(ctx) {
   };
 }
 // src/shared-hooks/session-recovery/storage.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync4, readdirSync as readdirSync3, readFileSync as readFileSync8, unlinkSync as unlinkSync2, writeFileSync as writeFileSync5 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync4, readdirSync as readdirSync4, readFileSync as readFileSync8, unlinkSync as unlinkSync2, writeFileSync as writeFileSync5 } from "fs";
+import { join as join15 } from "path";
 
 // src/shared-hooks/session-recovery/constants.ts
-import { join as join13 } from "path";
-import { homedir as homedir3 } from "os";
-var xdgData3 = process.env.XDG_DATA_HOME || join13(homedir3(), ".local", "share");
-var OPENCODE_STORAGE3 = join13(xdgData3, "opencode", "storage");
-var MESSAGE_STORAGE2 = join13(OPENCODE_STORAGE3, "message");
-var PART_STORAGE2 = join13(OPENCODE_STORAGE3, "part");
+import { join as join14 } from "path";
+import { homedir as homedir4 } from "os";
+var xdgData3 = process.env.XDG_DATA_HOME || join14(homedir4(), ".local", "share");
+var OPENCODE_STORAGE3 = join14(xdgData3, "opencode", "storage");
+var MESSAGE_STORAGE2 = join14(OPENCODE_STORAGE3, "message");
+var PART_STORAGE2 = join14(OPENCODE_STORAGE3, "part");
 var THINKING_TYPES2 = new Set(["thinking", "redacted_thinking", "reasoning"]);
 var META_TYPES2 = new Set(["step-start", "step-finish"]);
 var CONTENT_TYPES2 = new Set(["text", "tool", "tool_use", "tool_result"]);
@@ -3721,12 +3810,12 @@ var CONTENT_TYPES2 = new Set(["text", "tool", "tool_use", "tool_result"]);
 function getMessageDir2(sessionID) {
   if (!existsSync9(MESSAGE_STORAGE2))
     return "";
-  const directPath = join14(MESSAGE_STORAGE2, sessionID);
+  const directPath = join15(MESSAGE_STORAGE2, sessionID);
   if (existsSync9(directPath)) {
     return directPath;
   }
-  for (const dir of readdirSync3(MESSAGE_STORAGE2)) {
-    const sessionPath = join14(MESSAGE_STORAGE2, dir, sessionID);
+  for (const dir of readdirSync4(MESSAGE_STORAGE2)) {
+    const sessionPath = join15(MESSAGE_STORAGE2, dir, sessionID);
     if (existsSync9(sessionPath)) {
       return sessionPath;
     }
@@ -3738,11 +3827,11 @@ function readMessages(sessionID) {
   if (!messageDir || !existsSync9(messageDir))
     return [];
   const messages = [];
-  for (const file of readdirSync3(messageDir)) {
+  for (const file of readdirSync4(messageDir)) {
     if (!file.endsWith(".json"))
       continue;
     try {
-      const content = readFileSync8(join14(messageDir, file), "utf-8");
+      const content = readFileSync8(join15(messageDir, file), "utf-8");
       messages.push(JSON.parse(content));
     } catch {
       continue;
@@ -3757,15 +3846,15 @@ function readMessages(sessionID) {
   });
 }
 function readParts(messageID) {
-  const partDir = join14(PART_STORAGE2, messageID);
+  const partDir = join15(PART_STORAGE2, messageID);
   if (!existsSync9(partDir))
     return [];
   const parts = [];
-  for (const file of readdirSync3(partDir)) {
+  for (const file of readdirSync4(partDir)) {
     if (!file.endsWith(".json"))
       continue;
     try {
-      const content = readFileSync8(join14(partDir, file), "utf-8");
+      const content = readFileSync8(join15(partDir, file), "utf-8");
       parts.push(JSON.parse(content));
     } catch {
       continue;
@@ -3807,7 +3896,7 @@ function findMessagesWithOrphanThinking(sessionID) {
   return result;
 }
 function prependThinkingPart(sessionID, messageID) {
-  const partDir = join14(PART_STORAGE2, messageID);
+  const partDir = join15(PART_STORAGE2, messageID);
   if (!existsSync9(partDir)) {
     mkdirSync4(partDir, { recursive: true });
   }
@@ -3821,22 +3910,22 @@ function prependThinkingPart(sessionID, messageID) {
     synthetic: true
   };
   try {
-    writeFileSync5(join14(partDir, `${partId}.json`), JSON.stringify(part, null, 2));
+    writeFileSync5(join15(partDir, `${partId}.json`), JSON.stringify(part, null, 2));
     return true;
   } catch {
     return false;
   }
 }
 function stripThinkingParts(messageID) {
-  const partDir = join14(PART_STORAGE2, messageID);
+  const partDir = join15(PART_STORAGE2, messageID);
   if (!existsSync9(partDir))
     return false;
   let anyRemoved = false;
-  for (const file of readdirSync3(partDir)) {
+  for (const file of readdirSync4(partDir)) {
     if (!file.endsWith(".json"))
       continue;
     try {
-      const filePath = join14(partDir, file);
+      const filePath = join15(partDir, file);
       const content = readFileSync8(filePath, "utf-8");
       const part = JSON.parse(content);
       if (THINKING_TYPES2.has(part.type)) {
@@ -4163,16 +4252,16 @@ ${CONTEXT_REMINDER}
   };
 }
 // src/shared-hooks/background-agent/manager.ts
-import { existsSync as existsSync10, readdirSync as readdirSync4 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync10, readdirSync as readdirSync5 } from "fs";
+import { join as join16 } from "path";
 function getMessageDir3(sessionID) {
   if (!existsSync10(MESSAGE_STORAGE))
     return null;
-  const directPath = join15(MESSAGE_STORAGE, sessionID);
+  const directPath = join16(MESSAGE_STORAGE, sessionID);
   if (existsSync10(directPath))
     return directPath;
-  for (const dir of readdirSync4(MESSAGE_STORAGE)) {
-    const sessionPath = join15(MESSAGE_STORAGE, dir, sessionID);
+  for (const dir of readdirSync5(MESSAGE_STORAGE)) {
+    const sessionPath = join16(MESSAGE_STORAGE, dir, sessionID);
     if (existsSync10(sessionPath))
       return sessionPath;
   }
@@ -17115,13 +17204,13 @@ Status: ${task.status}`;
   });
 }
 // src/tools/skill/tools.ts
-import { existsSync as existsSync11, readdirSync as readdirSync5, readFileSync as readFileSync9, lstatSync, readlinkSync } from "fs";
-import { homedir as homedir4 } from "os";
-import { join as join16, basename as basename2, resolve as resolve2, dirname as dirname5 } from "path";
+import { existsSync as existsSync11, readdirSync as readdirSync6, readFileSync as readFileSync9, lstatSync, readlinkSync } from "fs";
+import { homedir as homedir5 } from "os";
+import { join as join17, basename as basename2, resolve as resolve2, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __filename3 = fileURLToPath2(import.meta.url);
 var __dirname3 = dirname5(__filename3);
-var NPM_DEFAULTS_SKILL_DIR = join16(__dirname3, "..", "..", "defaults", "skill");
+var NPM_DEFAULTS_SKILL_DIR = join17(__dirname3, "..", "..", "defaults", "skill");
 function deduplicateSkills(skills) {
   const seen = new Set;
   return skills.filter((skill) => {
@@ -17194,6 +17283,7 @@ function parseSkillFrontmatter(data) {
     description: typeof data.description === "string" ? data.description : "",
     license: typeof data.license === "string" ? data.license : undefined,
     "allowed-tools": Array.isArray(data["allowed-tools"]) ? data["allowed-tools"] : undefined,
+    triggers: Array.isArray(data.triggers) ? data.triggers : undefined,
     metadata: typeof data.metadata === "object" && data.metadata !== null ? data.metadata : undefined
   };
 }
@@ -17201,15 +17291,15 @@ function discoverSkillsFromDir(skillsDir, scope) {
   if (!existsSync11(skillsDir)) {
     return [];
   }
-  const entries = readdirSync5(skillsDir, { withFileTypes: true });
+  const entries = readdirSync6(skillsDir, { withFileTypes: true });
   const skills = [];
   for (const entry of entries) {
     if (entry.name.startsWith("."))
       continue;
-    const skillPath = join16(skillsDir, entry.name);
+    const skillPath = join17(skillsDir, entry.name);
     if (entry.isDirectory() || entry.isSymbolicLink()) {
       const resolvedPath = resolveSymlink(skillPath);
-      const skillMdPath = join16(resolvedPath, "SKILL.md");
+      const skillMdPath = join17(resolvedPath, "SKILL.md");
       if (!existsSync11(skillMdPath))
         continue;
       try {
@@ -17218,7 +17308,8 @@ function discoverSkillsFromDir(skillsDir, scope) {
         skills.push({
           name: data.name || entry.name,
           description: data.description || "",
-          scope
+          scope,
+          triggers: Array.isArray(data.triggers) ? data.triggers : undefined
         });
       } catch {
         continue;
@@ -17228,16 +17319,35 @@ function discoverSkillsFromDir(skillsDir, scope) {
   return skills;
 }
 function discoverSkillsSync() {
-  const userSkillsDir = join16(homedir4(), ".opencode", "skill");
-  const projectSkillsDir = join16(process.cwd(), ".opencode", "skill");
+  const userSkillsDir = join17(homedir5(), ".opencode", "skill");
+  const projectSkillsDir = join17(process.cwd(), ".opencode", "skill");
   const builtinSkills = discoverSkillsFromDir(NPM_DEFAULTS_SKILL_DIR, "builtin");
   const userSkills = discoverSkillsFromDir(userSkillsDir, "user");
   const projectSkills = discoverSkillsFromDir(projectSkillsDir, "project");
   return deduplicateSkills([...projectSkills, ...userSkills, ...builtinSkills]);
 }
+function buildTriggerSection(skills) {
+  const skillsWithTriggers = skills.filter((s) => s.triggers && s.triggers.length > 0);
+  if (skillsWithTriggers.length === 0) {
+    return "";
+  }
+  const lines = [
+    `
+
+Skill Triggers (invoke skill when user says these phrases):`
+  ];
+  for (const skill of skillsWithTriggers) {
+    const triggers = skill.triggers.map((t) => `"${t}"`).join(", ");
+    lines.push(`- ${triggers} \u2192 ${skill.name}`);
+  }
+  lines.push(`
+IMPORTANT: If user intent matches a trigger phrase, invoke the skill immediately. Don't improvise.`);
+  return lines.join(`
+`);
+}
 async function parseSkillMd(skillPath) {
   const resolvedPath = resolveSymlink(skillPath);
-  const skillMdPath = join16(resolvedPath, "SKILL.md");
+  const skillMdPath = join17(resolvedPath, "SKILL.md");
   if (!existsSync11(skillMdPath)) {
     return null;
   }
@@ -17250,14 +17360,15 @@ async function parseSkillMd(skillPath) {
       description: frontmatter.description,
       license: frontmatter.license,
       allowedTools: frontmatter["allowed-tools"],
+      triggers: frontmatter.triggers,
       metadata: frontmatter.metadata
     };
-    const referencesDir = join16(resolvedPath, "references");
-    const scriptsDir = join16(resolvedPath, "scripts");
-    const assetsDir = join16(resolvedPath, "assets");
-    const references = existsSync11(referencesDir) ? readdirSync5(referencesDir).filter((f) => !f.startsWith(".")) : [];
-    const scripts = existsSync11(scriptsDir) ? readdirSync5(scriptsDir).filter((f) => !f.startsWith(".") && !f.startsWith("__")) : [];
-    const assets = existsSync11(assetsDir) ? readdirSync5(assetsDir).filter((f) => !f.startsWith(".")) : [];
+    const referencesDir = join17(resolvedPath, "references");
+    const scriptsDir = join17(resolvedPath, "scripts");
+    const assetsDir = join17(resolvedPath, "assets");
+    const references = existsSync11(referencesDir) ? readdirSync6(referencesDir).filter((f) => !f.startsWith(".")) : [];
+    const scripts = existsSync11(scriptsDir) ? readdirSync6(scriptsDir).filter((f) => !f.startsWith(".") && !f.startsWith("__")) : [];
+    const assets = existsSync11(assetsDir) ? readdirSync6(assetsDir).filter((f) => !f.startsWith(".")) : [];
     return {
       name: metadata.name,
       path: resolvedPath,
@@ -17276,12 +17387,12 @@ async function discoverSkillsFromDirAsync(skillsDir) {
   if (!existsSync11(skillsDir)) {
     return [];
   }
-  const entries = readdirSync5(skillsDir, { withFileTypes: true });
+  const entries = readdirSync6(skillsDir, { withFileTypes: true });
   const skills = [];
   for (const entry of entries) {
     if (entry.name.startsWith("."))
       continue;
-    const skillPath = join16(skillsDir, entry.name);
+    const skillPath = join17(skillsDir, entry.name);
     if (entry.isDirectory() || entry.isSymbolicLink()) {
       const skillInfo = await parseSkillMd(skillPath);
       if (skillInfo) {
@@ -17292,8 +17403,8 @@ async function discoverSkillsFromDirAsync(skillsDir) {
   return skills;
 }
 async function discoverSkills() {
-  const userSkillsDir = join16(homedir4(), ".opencode", "skill");
-  const projectSkillsDir = join16(process.cwd(), ".opencode", "skill");
+  const userSkillsDir = join17(homedir5(), ".opencode", "skill");
+  const projectSkillsDir = join17(process.cwd(), ".opencode", "skill");
   const builtinSkills = await discoverSkillsFromDirAsync(NPM_DEFAULTS_SKILL_DIR);
   const userSkills = await discoverSkillsFromDirAsync(userSkillsDir);
   const projectSkills = await discoverSkillsFromDirAsync(projectSkillsDir);
@@ -17323,7 +17434,7 @@ async function loadSkillWithReferences(skill, includeRefs) {
   const referencesLoaded = [];
   if (includeRefs && skill.references.length > 0) {
     for (const ref of skill.references) {
-      const refPath = join16(skill.path, "references", ref);
+      const refPath = join17(skill.path, "references", ref);
       try {
         const content = readFileSync9(refPath, "utf-8");
         referencesLoaded.push({ path: ref, content });
@@ -17384,13 +17495,14 @@ function createSkillTool() {
   const availableSkills = discoverSkillsSync();
   const skillListForDescription = availableSkills.map((s) => `- ${s.name}: ${s.description} (${s.scope})`).join(`
 `);
+  const triggerSection = buildTriggerSection(availableSkills);
   return tool({
     description: `Execute a skill within the main conversation.
 
 When you invoke a skill, the skill's prompt will expand and provide detailed instructions on how to complete the task.
 
 Available Skills:
-${skillListForDescription || "(No skills discovered yet)"}`,
+${skillListForDescription || "(No skills discovered yet)"}${triggerSection}`,
     args: {
       skill: tool.schema.string().describe("The skill name or search query to find and load. Can be exact skill name (e.g., 'morning-boot') or keywords (e.g., 'morning', 'boot').")
     },

package/dist/tools/skill/types.d.ts

@@ -5,6 +5,7 @@ export declare const SkillFrontmatterSchema: z.ZodObject<{
     description: z.ZodString;
     license: z.ZodOptional<z.ZodString>;
     "allowed-tools": z.ZodOptional<z.ZodArray<z.ZodString>>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;
@@ -13,6 +14,7 @@ export interface SkillMetadata {
     description: string;
     license?: string;
     allowedTools?: string[];
+    triggers?: string[];
     metadata?: Record<string, string>;
 }
 export interface SkillInfo {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-plugin",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Thoth - Root-level life orchestrator for OpenCode. Unified AI chief of staff combining Sisyphus execution quality, Personal-OS rhythms, and Thoth relationship model.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",