@skillkit/core 1.6.2 → 1.6.4

package/dist/index.js

@@ -65,6 +65,203 @@ var SkillkitConfig = z.object({
   defaultTimeout: z.number().optional()
 });
 
+// src/agent-config.ts
+var AGENT_CONFIG = {
+  // Claude Code - all Claude products use the same format
+  "claude-code": {
+    skillsDir: ".claude/skills",
+    configFile: "CLAUDE.md",
+    globalSkillsDir: "~/.claude/skills",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    frontmatterFields: [
+      "name",
+      "description",
+      "allowed-tools",
+      "model",
+      "context",
+      "agent",
+      "disable-model-invocation",
+      "user-invocable",
+      "argument-hint"
+    ],
+    supportsAutoDiscovery: true
+  },
+  // Cursor - uses MDC format in .cursor/rules/
+  cursor: {
+    skillsDir: ".cursor/skills",
+    configFile: ".cursor/rules/skills.mdc",
+    altSkillsDirs: [".cursor/commands"],
+    globalSkillsDir: "~/.cursor/skills",
+    configFormat: "mdc",
+    usesFrontmatter: true,
+    frontmatterFields: ["description", "globs", "alwaysApply"],
+    supportsAutoDiscovery: true
+  },
+  // Codex (OpenAI)
+  codex: {
+    skillsDir: ".codex/skills",
+    configFile: "AGENTS.md",
+    globalSkillsDir: "~/.codex/skills",
+    configFormat: "markdown-table",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Gemini CLI
+  "gemini-cli": {
+    skillsDir: ".gemini/skills",
+    configFile: "GEMINI.md",
+    globalSkillsDir: "~/.gemini/skills",
+    configFormat: "json",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // OpenCode
+  opencode: {
+    skillsDir: ".opencode/skills",
+    configFile: "AGENTS.md",
+    altSkillsDirs: [".opencode/agent"],
+    globalSkillsDir: "~/.config/opencode/skills",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Antigravity
+  antigravity: {
+    skillsDir: ".antigravity/skills",
+    configFile: "AGENTS.md",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Amp - uses .amp/ directory
+  amp: {
+    skillsDir: ".amp/skills",
+    configFile: "AGENTS.md",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Clawdbot
+  clawdbot: {
+    skillsDir: ".clawdbot/skills",
+    configFile: "AGENTS.md",
+    altSkillsDirs: ["skills"],
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Droid (Factory)
+  droid: {
+    skillsDir: ".factory/skills",
+    configFile: "AGENTS.md",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // GitHub Copilot
+  "github-copilot": {
+    skillsDir: ".github/skills",
+    configFile: ".github/copilot-instructions.md",
+    altSkillsDirs: [".github/instructions"],
+    configFormat: "markdown",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Goose
+  goose: {
+    skillsDir: ".goose/skills",
+    configFile: "AGENTS.md",
+    globalSkillsDir: "~/.goose/skills",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Kilo
+  kilo: {
+    skillsDir: ".kilocode/skills",
+    configFile: "AGENTS.md",
+    altSkillsDirs: [".kilocode/modes"],
+    globalSkillsDir: "~/.kilocode/skills",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Kiro CLI
+  "kiro-cli": {
+    skillsDir: ".kiro/skills",
+    configFile: "AGENTS.md",
+    globalSkillsDir: "~/.kiro/skills",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Roo Code
+  roo: {
+    skillsDir: ".roo/skills",
+    configFile: "AGENTS.md",
+    altSkillsDirs: [".roo/modes"],
+    globalSkillsDir: "~/.roo/skills",
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Trae
+  trae: {
+    skillsDir: ".trae/skills",
+    configFile: ".trae/rules/project_rules.md",
+    altSkillsDirs: [".trae/agent"],
+    configFormat: "markdown",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Windsurf
+  windsurf: {
+    skillsDir: ".windsurf/skills",
+    configFile: ".windsurf/rules/skills.md",
+    altSkillsDirs: [".windsurf/workflows"],
+    globalSkillsDir: "~/.codeium/windsurf/skills",
+    configFormat: "markdown",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  },
+  // Universal - works with any agent
+  universal: {
+    skillsDir: "skills",
+    configFile: "AGENTS.md",
+    altSkillsDirs: [".agent/skills", ".agents/skills"],
+    configFormat: "xml",
+    usesFrontmatter: true,
+    supportsAutoDiscovery: true
+  }
+};
+function getAgentDirectoryConfig(agent) {
+  return AGENT_CONFIG[agent];
+}
+function getSkillsDir(agent) {
+  return AGENT_CONFIG[agent].skillsDir;
+}
+function getConfigFile(agent) {
+  return AGENT_CONFIG[agent].configFile;
+}
+function getAllSkillsDirs(agent) {
+  const config = AGENT_CONFIG[agent];
+  const dirs = [config.skillsDir];
+  if (config.altSkillsDirs) {
+    dirs.push(...config.altSkillsDirs);
+  }
+  return dirs;
+}
+function getGlobalSkillsDir(agent) {
+  return AGENT_CONFIG[agent].globalSkillsDir;
+}
+function supportsAutoDiscovery(agent) {
+  return AGENT_CONFIG[agent].supportsAutoDiscovery;
+}
+function getConfigFormat(agent) {
+  return AGENT_CONFIG[agent].configFormat;
+}
+
 // src/skills.ts
 import { existsSync, readdirSync, readFileSync } from "fs";
 import { join, basename } from "path";
@@ -324,8 +521,8 @@ function validateSkill(skillPath) {
   return { valid: errors.length === 0, errors, warnings };
 }
 function isPathInside(child, parent) {
-  const relative3 = child.replace(parent, "");
-  return !relative3.startsWith("..") && !relative3.includes("/..");
+  const relative4 = child.replace(parent, "");
+  return !relative4.startsWith("..") && !relative4.includes("/..");
 }
 
 // src/config.ts
@@ -2770,25 +2967,6 @@ function initContext(projectPath, options) {
 // src/context/sync.ts
 import { existsSync as existsSync10, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, copyFileSync, readdirSync as readdirSync3 } from "fs";
 import { join as join9 } from "path";
-var AGENT_DIRS = {
-  "claude-code": { skillsDir: ".claude/skills", configFile: "AGENTS.md" },
-  "cursor": { skillsDir: ".cursor/skills", configFile: ".cursorrules" },
-  "codex": { skillsDir: ".codex/skills", configFile: "AGENTS.md" },
-  "gemini-cli": { skillsDir: ".gemini/skills", configFile: "GEMINI.md" },
-  "opencode": { skillsDir: ".opencode/skills", configFile: "AGENTS.md" },
-  "antigravity": { skillsDir: ".antigravity/skills", configFile: "AGENTS.md" },
-  "amp": { skillsDir: ".agents/skills", configFile: "AGENTS.md" },
-  "clawdbot": { skillsDir: "skills", configFile: "AGENTS.md" },
-  "droid": { skillsDir: ".factory/skills", configFile: "AGENTS.md" },
-  "github-copilot": { skillsDir: ".github/skills", configFile: "AGENTS.md" },
-  "goose": { skillsDir: ".goose/skills", configFile: "AGENTS.md" },
-  "kilo": { skillsDir: ".kilocode/skills", configFile: "AGENTS.md" },
-  "kiro-cli": { skillsDir: ".kiro/skills", configFile: "AGENTS.md" },
-  "roo": { skillsDir: ".roo/skills", configFile: "AGENTS.md" },
-  "trae": { skillsDir: ".trae/skills", configFile: "AGENTS.md" },
-  "windsurf": { skillsDir: ".windsurf/skills", configFile: "AGENTS.md" },
-  "universal": { skillsDir: ".agent/skills", configFile: "AGENTS.md" }
-};
 var ContextSync = class {
   projectPath;
   contextManager;
@@ -2801,7 +2979,7 @@ var ContextSync = class {
    */
   detectAgents() {
     const detected = [];
-    for (const [agent, config] of Object.entries(AGENT_DIRS)) {
+    for (const [agent, config] of Object.entries(AGENT_CONFIG)) {
       const skillsPath = join9(this.projectPath, config.skillsDir);
       const configPath = join9(this.projectPath, config.configFile);
       if (existsSync10(skillsPath) || existsSync10(configPath)) {
@@ -2870,7 +3048,7 @@ var ContextSync = class {
       files: []
     };
     const sourceSkills = skills || this.getSourceSkills();
-    const agentConfig = AGENT_DIRS[agent];
+    const agentConfig = AGENT_CONFIG[agent];
     if (!agentConfig) {
       result.success = false;
       result.errors.push(`Unknown agent: ${agent}`);
@@ -2961,8 +3139,8 @@ var ContextSync = class {
     const context = this.contextManager.get();
     const primaryAgent = context?.agents?.primary;
     const searchDirs = [];
-    if (primaryAgent && AGENT_DIRS[primaryAgent]) {
-      searchDirs.push(join9(this.projectPath, AGENT_DIRS[primaryAgent].skillsDir));
+    if (primaryAgent && AGENT_CONFIG[primaryAgent]) {
+      searchDirs.push(join9(this.projectPath, AGENT_CONFIG[primaryAgent].skillsDir));
     }
     const commonDirs = [
       ".claude/skills",
@@ -2984,7 +3162,7 @@ var ContextSync = class {
    */
   checkStatus() {
     const status = {};
-    for (const [agent, config] of Object.entries(AGENT_DIRS)) {
+    for (const [agent, config] of Object.entries(AGENT_CONFIG)) {
       const skillsPath = join9(this.projectPath, config.skillsDir);
       const skills = [];
       if (existsSync10(skillsPath)) {
@@ -3913,8 +4091,8 @@ async function buildSkillIndex(repos = KNOWN_SKILL_REPOS, onProgress) {
     onProgress?.("No skills fetched, using sample index...");
     allSkills.push(...getSampleSkills());
     sources.push({
-      name: "skillkit-samples",
-      url: "https://github.com/skillkit/samples",
+      name: "built-in",
+      url: "https://github.com/rohitg00/skillkit",
       lastFetched: (/* @__PURE__ */ new Date()).toISOString(),
       skillCount: allSkills.length
     });
@@ -3960,7 +4138,7 @@ function getSampleSkills() {
     {
       name: "react-best-practices",
       description: "Modern React patterns including Server Components, hooks best practices, and performance optimization",
-      source: "skillkit/samples",
+      source: "built-in",
       tags: ["react", "frontend", "typescript", "nextjs", "performance"],
       compatibility: {
         frameworks: ["react", "nextjs"],
@@ -3975,7 +4153,7 @@ function getSampleSkills() {
     {
       name: "tailwind-patterns",
       description: "Tailwind CSS utility patterns, responsive design, and component styling best practices",
-      source: "skillkit/samples",
+      source: "built-in",
       tags: ["tailwind", "css", "styling", "frontend", "responsive"],
       compatibility: {
         frameworks: [],
@@ -3990,7 +4168,7 @@ function getSampleSkills() {
     {
       name: "typescript-strict-patterns",
       description: "TypeScript strict mode patterns, type safety, and advanced type utilities",
-      source: "skillkit/samples",
+      source: "built-in",
       tags: ["typescript", "types", "safety", "patterns"],
       compatibility: {
         frameworks: [],
@@ -4005,7 +4183,7 @@ function getSampleSkills() {
     {
       name: "security-best-practices",
       description: "Security patterns for web applications including XSS prevention, CSRF, and secure headers",
-      source: "skillkit/samples",
+      source: "built-in",
       tags: ["security", "xss", "csrf", "headers", "owasp"],
       compatibility: {
         frameworks: [],
@@ -4020,7 +4198,7 @@ function getSampleSkills() {
     {
       name: "testing-patterns",
       description: "Testing patterns with Vitest/Jest including mocking, assertions, and test organization",
-      source: "skillkit/samples",
+      source: "built-in",
       tags: ["vitest", "jest", "testing", "typescript", "mocking", "tdd"],
       compatibility: {
         frameworks: [],
@@ -4914,7 +5092,7 @@ var SkillExecutionEngine = class {
     const startTime = /* @__PURE__ */ new Date();
     const taskId = task.id || randomUUID6();
     try {
-      await new Promise((resolve3) => setTimeout(resolve3, 100));
+      await new Promise((resolve4) => setTimeout(resolve4, 100));
       const endTime = /* @__PURE__ */ new Date();
       return {
         taskId,
@@ -5251,7 +5429,7 @@ async function executeWithAgent(agentType, prompt, options = {}) {
   });
 }
 async function executeCommand(command, args, options = {}) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const startTime = Date.now();
     let stdout = "";
     let stderr = "";
@@ -5274,7 +5452,7 @@ async function executeCommand(command, args, options = {}) {
     });
     child.on("error", (error) => {
       if (timeoutId) clearTimeout(timeoutId);
-      resolve3({
+      resolve4({
         success: false,
         output: stdout,
         error: error.message,
@@ -5284,7 +5462,7 @@ async function executeCommand(command, args, options = {}) {
     });
     child.on("close", (code) => {
       if (timeoutId) clearTimeout(timeoutId);
-      resolve3({
+      resolve4({
         success: code === 0 && !timedOut,
         output: stdout,
         error: timedOut ? "Execution timed out" : stderr || void 0,
@@ -5479,7 +5657,7 @@ function createSimulatedSkillExecutor(options = {}) {
   const { delay = 100, shouldFail, onExecute } = options;
   return async (skillName, _config) => {
     onExecute?.(skillName);
-    await new Promise((resolve3) => setTimeout(resolve3, delay));
+    await new Promise((resolve4) => setTimeout(resolve4, delay));
     const failed = shouldFail?.(skillName) ?? false;
     return {
       success: !failed,
@@ -5928,12 +6106,12 @@ function assertEnvVarSet(assertion, startTime) {
   };
 }
 async function checkPortAvailable(port) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const server = createServer();
-    server.once("error", () => resolve3(false));
+    server.once("error", () => resolve4(false));
     server.once("listening", () => {
       server.close();
-      resolve3(true);
+      resolve4(true);
     });
     server.listen(port, "127.0.0.1");
   });
@@ -6455,9 +6633,9 @@ var MarketplaceAggregator = class {
       const context = readme.slice(contextStart, contextEnd);
       const descMatch = context.match(/[-*]\s*\[.*?\]\(.*?\)\s*[-:]\s*(.+?)(?:\n|$)/);
       const description = descMatch ? descMatch[1].trim() : "";
-      const isAbsolute2 = this.isAbsoluteUrl(path2);
-      const normalizedPath = isAbsolute2 ? path2 : path2.startsWith("/") ? path2 : `/${path2}`;
-      const rawUrl = isAbsolute2 ? this.toRawUrl(path2) : `https://raw.githubusercontent.com/${source.owner}/${source.repo}/${branch}/${path2}`;
+      const isAbsolute3 = this.isAbsoluteUrl(path2);
+      const normalizedPath = isAbsolute3 ? path2 : path2.startsWith("/") ? path2 : `/${path2}`;
+      const rawUrl = isAbsolute3 ? this.toRawUrl(path2) : `https://raw.githubusercontent.com/${source.owner}/${source.repo}/${branch}/${path2}`;
       skills.push({
         id: `${source.owner}/${source.repo}/${path2}`,
         name,
@@ -14332,8 +14510,8 @@ var PlanExecutor = class {
   pause() {
     if (!this.isPaused) {
       this.isPaused = true;
-      this.resumePromise = new Promise((resolve3) => {
-        this.resumeResolve = resolve3;
+      this.resumePromise = new Promise((resolve4) => {
+        this.resumeResolve = resolve4;
       });
       this.emit("plan:paused", {});
     }
@@ -15865,21 +16043,21 @@ var AgentMetadata = z5.object({
 });
 var AGENT_DISCOVERY_PATHS = {
   "claude-code": [".claude/agents"],
-  "cursor": [".cursor/agents"],
+  "cursor": [".cursor/agents", ".cursor/commands"],
   "codex": [".codex/agents"],
   "gemini-cli": [".gemini/agents"],
-  "opencode": [".opencode/agents"],
+  "opencode": [".opencode/agents", ".opencode/agent"],
   "antigravity": [".antigravity/agents"],
   "amp": [".amp/agents"],
   "clawdbot": [".clawdbot/agents", "agents"],
   "droid": [".factory/agents"],
-  "github-copilot": [".github/agents", ".github/copilot/agents"],
+  "github-copilot": [".github/agents", ".github/instructions", ".github/custom-agents"],
   "goose": [".goose/agents"],
-  "kilo": [".kilocode/agents"],
+  "kilo": [".kilocode/agents", ".kilocode/modes"],
   "kiro-cli": [".kiro/agents"],
-  "roo": [".roo/agents"],
-  "trae": [".trae/agents"],
-  "windsurf": [".windsurf/agents"],
+  "roo": [".roo/agents", ".roo/modes"],
+  "trae": [".trae/agents", ".trae/agent"],
+  "windsurf": [".windsurf/agents", ".windsurf/workflows"],
   "universal": ["agents", ".agents"]
 };
 var ALL_AGENT_DISCOVERY_PATHS = [
@@ -15887,21 +16065,28 @@ var ALL_AGENT_DISCOVERY_PATHS = [
   ".agents",
   ".claude/agents",
   ".cursor/agents",
+  ".cursor/commands",
   ".codex/agents",
   ".gemini/agents",
   ".opencode/agents",
+  ".opencode/agent",
   ".antigravity/agents",
   ".amp/agents",
   ".clawdbot/agents",
   ".factory/agents",
   ".github/agents",
-  ".github/copilot/agents",
+  ".github/instructions",
+  ".github/custom-agents",
   ".goose/agents",
   ".kilocode/agents",
+  ".kilocode/modes",
   ".kiro/agents",
   ".roo/agents",
+  ".roo/modes",
   ".trae/agents",
-  ".windsurf/agents"
+  ".trae/agent",
+  ".windsurf/agents",
+  ".windsurf/workflows"
 ];
 var CUSTOM_AGENT_FORMAT_MAP = {
   "claude-code": "claude-agent",
@@ -16368,6 +16553,81 @@ function getAgentStats(searchDirs) {
     disabled: allAgents.filter((a) => !a.enabled).length
   };
 }
+function discoverAgentsRecursive(rootDir, location = "project") {
+  const agents = [];
+  const seen = /* @__PURE__ */ new Set();
+  if (!existsSync31(rootDir)) {
+    return agents;
+  }
+  function scanDirectory(dir) {
+    try {
+      const entries = readdirSync9(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const entryPath = join31(dir, entry.name);
+        if (entry.isFile() && extname3(entry.name) === ".md") {
+          const agent = parseAgentFile(entryPath, location);
+          if (agent && !seen.has(agent.name)) {
+            seen.add(agent.name);
+            agents.push(agent);
+          }
+        } else if (entry.isDirectory()) {
+          if (entry.name.startsWith(".") && !entry.name.startsWith(".claude") && !entry.name.startsWith(".cursor") && !entry.name.startsWith(".codex")) {
+            continue;
+          }
+          const agent = parseAgentDir(entryPath, location);
+          if (agent && !seen.has(agent.name)) {
+            seen.add(agent.name);
+            agents.push(agent);
+          } else {
+            scanDirectory(entryPath);
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  scanDirectory(rootDir);
+  return agents;
+}
+function discoverAgentsFromPath(sourcePath, recursive = false, location = "project") {
+  if (!existsSync31(sourcePath)) {
+    return [];
+  }
+  const stats = statSync8(sourcePath);
+  if (stats.isFile()) {
+    if (extname3(sourcePath) === ".md") {
+      const agent = parseAgentFile(sourcePath, location);
+      return agent ? [agent] : [];
+    }
+    return [];
+  }
+  if (stats.isDirectory()) {
+    if (recursive) {
+      return discoverAgentsRecursive(sourcePath, location);
+    }
+    const agent = parseAgentDir(sourcePath, location);
+    if (agent) {
+      return [agent];
+    }
+    const agents = [];
+    try {
+      const entries = readdirSync9(sourcePath, { withFileTypes: true });
+      for (const entry of entries) {
+        const entryPath = join31(sourcePath, entry.name);
+        if (entry.isFile() && extname3(entry.name) === ".md") {
+          const a = parseAgentFile(entryPath, location);
+          if (a) agents.push(a);
+        } else if (entry.isDirectory()) {
+          const a = parseAgentDir(entryPath, location);
+          if (a) agents.push(a);
+        }
+      }
+    } catch {
+    }
+    return agents;
+  }
+  return [];
+}
 
 // src/agents/translator.ts
 import { join as join32 } from "path";
@@ -16626,10 +16886,457 @@ function isAgentCompatible(sourceFormat, targetFormat) {
   }
   return { compatible: true, warnings };
 }
+
+// src/skill-translator.ts
+import { readFileSync as readFileSync24, existsSync as existsSync32, writeFileSync as writeFileSync17, mkdirSync as mkdirSync18 } from "fs";
+import { join as join33, basename as basename11, dirname as dirname11, resolve as resolve3, relative as relative3, isAbsolute as isAbsolute2 } from "path";
+import { parse as parseYaml11, stringify as stringifyYaml8 } from "yaml";
+var AGENT_SKILL_FORMATS = Object.fromEntries(
+  Object.entries(AGENT_CONFIG).map(([agent, config]) => [
+    agent,
+    { ...config, invokeCommand: "skillkit read" }
+  ])
+);
+function parseSkillToCanonical(skillPath, sourceAgent) {
+  const skillMdPath = skillPath.endsWith("SKILL.md") ? skillPath : join33(skillPath, "SKILL.md");
+  if (!existsSync32(skillMdPath)) {
+    return null;
+  }
+  try {
+    const content = readFileSync24(skillMdPath, "utf-8");
+    return parseSkillContentToCanonical(content, skillPath, sourceAgent);
+  } catch {
+    return null;
+  }
+}
+function parseSkillContentToCanonical(content, sourcePath, sourceAgent) {
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  let frontmatter = {};
+  let bodyContent = content;
+  if (frontmatterMatch) {
+    try {
+      frontmatter = parseYaml11(frontmatterMatch[1]);
+      bodyContent = content.slice(frontmatterMatch[0].length).trim();
+    } catch {
+    }
+  }
+  const name = frontmatter.name || basename11(sourcePath.endsWith(".md") ? dirname11(sourcePath) : sourcePath);
+  const description = frontmatter.description || extractDescriptionFromContent(bodyContent);
+  return {
+    name,
+    description,
+    content: bodyContent,
+    frontmatter,
+    sourcePath,
+    sourceAgent,
+    version: frontmatter.version,
+    author: frontmatter.author,
+    tags: frontmatter.tags,
+    allowedTools: parseAllowedTools(frontmatter["allowed-tools"]),
+    agentFields: extractAgentSpecificFields(frontmatter, sourceAgent)
+  };
+}
+function extractDescriptionFromContent(content) {
+  const lines = content.split("\n").filter((line) => line.trim());
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("#")) continue;
+    if (trimmed.startsWith("```")) continue;
+    if (trimmed.length > 10) {
+      return trimmed.slice(0, 200) + (trimmed.length > 200 ? "..." : "");
+    }
+  }
+  return "No description available";
+}
+function parseAllowedTools(value) {
+  if (!value) return void 0;
+  if (Array.isArray(value)) return value;
+  if (typeof value === "string") {
+    return value.split(",").map((t) => t.trim()).filter(Boolean);
+  }
+  return void 0;
+}
+function extractAgentSpecificFields(frontmatter, _sourceAgent) {
+  const agentFields = {};
+  const specialFields = [
+    "disable-model-invocation",
+    "user-invocable",
+    "argument-hint",
+    "model",
+    "context",
+    "agent",
+    "globs",
+    "alwaysApply",
+    "applyTo",
+    "mode",
+    "hooks",
+    "permissionMode"
+  ];
+  for (const field of specialFields) {
+    if (field in frontmatter) {
+      agentFields[field] = frontmatter[field];
+    }
+  }
+  return agentFields;
+}
+function translateSkillToAgent(canonical, targetAgent, options) {
+  const format = AGENT_SKILL_FORMATS[targetAgent];
+  const warnings = [];
+  const incompatible = [];
+  if (canonical.agentFields?.["hooks"] && targetAgent !== "claude-code") {
+    incompatible.push("hooks (only supported in Claude Code)");
+  }
+  if (canonical.agentFields?.["permissionMode"] && !["claude-code", "roo"].includes(targetAgent)) {
+    warnings.push("permissionMode may not be fully supported");
+  }
+  const content = generateSkillContent(canonical, targetAgent, format, options);
+  const filename = options?.outputFilename || "SKILL.md";
+  const targetDir = options?.outputDir || join33(format.skillsDir, canonical.name);
+  return {
+    success: true,
+    content,
+    filename,
+    targetDir,
+    warnings,
+    incompatible,
+    targetAgent
+  };
+}
+function generateSkillContent(canonical, targetAgent, format, options) {
+  const lines = [];
+  const frontmatter = {
+    name: canonical.name,
+    description: canonical.description
+  };
+  if (canonical.version) {
+    frontmatter.version = canonical.version;
+  }
+  if (canonical.author) {
+    frontmatter.author = canonical.author;
+  }
+  if (canonical.tags && canonical.tags.length > 0) {
+    frontmatter.tags = canonical.tags;
+  }
+  if (canonical.allowedTools && canonical.allowedTools.length > 0) {
+    frontmatter["allowed-tools"] = canonical.allowedTools.join(", ");
+  }
+  addAgentSpecificFields(frontmatter, canonical, targetAgent, format);
+  if (options?.addMetadata && canonical.sourceAgent) {
+    frontmatter["_translated-from"] = canonical.sourceAgent;
+    frontmatter["_translated-at"] = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  lines.push("---");
+  lines.push(stringifyYaml8(frontmatter).trim());
+  lines.push("---");
+  lines.push("");
+  lines.push(canonical.content);
+  return lines.join("\n");
+}
+function addAgentSpecificFields(frontmatter, canonical, targetAgent, _format) {
+  if (targetAgent === "claude-code") {
+    if ("model" in (canonical.agentFields ?? {})) {
+      frontmatter.model = canonical.agentFields["model"];
+    }
+    if ("context" in (canonical.agentFields ?? {})) {
+      frontmatter.context = canonical.agentFields["context"];
+    }
+    if ("agent" in (canonical.agentFields ?? {})) {
+      frontmatter.agent = canonical.agentFields["agent"];
+    }
+    if ("disable-model-invocation" in (canonical.agentFields ?? {})) {
+      frontmatter["disable-model-invocation"] = canonical.agentFields["disable-model-invocation"];
+    }
+    if ("user-invocable" in (canonical.agentFields ?? {})) {
+      frontmatter["user-invocable"] = canonical.agentFields["user-invocable"];
+    }
+    if ("argument-hint" in (canonical.agentFields ?? {})) {
+      frontmatter["argument-hint"] = canonical.agentFields["argument-hint"];
+    }
+    if ("hooks" in (canonical.agentFields ?? {})) {
+      frontmatter.hooks = canonical.agentFields["hooks"];
+    }
+    if ("permissionMode" in (canonical.agentFields ?? {})) {
+      frontmatter.permissionMode = canonical.agentFields["permissionMode"];
+    }
+  }
+  if (["cursor", "trae", "windsurf"].includes(targetAgent)) {
+    if ("globs" in (canonical.agentFields ?? {})) {
+      frontmatter.globs = canonical.agentFields["globs"];
+    }
+    if ("alwaysApply" in (canonical.agentFields ?? {})) {
+      frontmatter.alwaysApply = canonical.agentFields["alwaysApply"];
+    }
+    if (targetAgent === "windsurf" && "mode" in (canonical.agentFields ?? {})) {
+      frontmatter.mode = canonical.agentFields["mode"];
+    }
+  }
+  if (targetAgent === "github-copilot") {
+    if ("applyTo" in (canonical.agentFields ?? {})) {
+      frontmatter.applyTo = canonical.agentFields["applyTo"];
+    }
+  }
+  if (targetAgent === "roo") {
+    if ("disable-model-invocation" in (canonical.agentFields ?? {})) {
+      frontmatter["disable-model-invocation"] = canonical.agentFields["disable-model-invocation"];
+    }
+    if ("user-invocable" in (canonical.agentFields ?? {})) {
+      frontmatter["user-invocable"] = canonical.agentFields["user-invocable"];
+    }
+    if ("permissionMode" in (canonical.agentFields ?? {})) {
+      frontmatter.permissionMode = canonical.agentFields["permissionMode"];
+    }
+  }
+}
+function translateSkillToAll(skillPath, sourceAgent, options) {
+  const canonical = parseSkillToCanonical(skillPath, sourceAgent);
+  if (!canonical) {
+    return /* @__PURE__ */ new Map();
+  }
+  const results = /* @__PURE__ */ new Map();
+  const agents = [
+    "claude-code",
+    "cursor",
+    "codex",
+    "gemini-cli",
+    "opencode",
+    "antigravity",
+    "amp",
+    "clawdbot",
+    "droid",
+    "github-copilot",
+    "goose",
+    "kilo",
+    "kiro-cli",
+    "roo",
+    "trae",
+    "windsurf",
+    "universal"
+  ];
+  for (const agent of agents) {
+    if (agent !== sourceAgent) {
+      results.set(agent, translateSkillToAgent(canonical, agent, options));
+    }
+  }
+  return results;
+}
+function writeTranslatedSkill(result, rootDir, options) {
+  if (!result.success) {
+    return {
+      success: false,
+      path: "",
+      error: "Translation failed"
+    };
+  }
+  try {
+    const rootPath = resolve3(rootDir);
+    const filePath = resolve3(rootDir, result.targetDir, result.filename);
+    const targetPath = dirname11(filePath);
+    const relPath = relative3(rootPath, filePath);
+    if (relPath.startsWith("..") || isAbsolute2(relPath)) {
+      return {
+        success: false,
+        path: filePath,
+        error: "Resolved output path escapes rootDir"
+      };
+    }
+    if (existsSync32(filePath) && options?.overwrite === false) {
+      return {
+        success: false,
+        path: filePath,
+        error: "File exists and overwrite=false",
+        skipped: true
+      };
+    }
+    if (!existsSync32(targetPath)) {
+      mkdirSync18(targetPath, { recursive: true });
+    }
+    writeFileSync17(filePath, result.content, "utf-8");
+    return { success: true, path: filePath };
+  } catch (error) {
+    return {
+      success: false,
+      path: "",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+function generateSkillsConfig(skills, targetAgent) {
+  const format = AGENT_SKILL_FORMATS[targetAgent];
+  const enabledSkills = skills.filter((s) => s.enabled);
+  if (enabledSkills.length === 0) {
+    return "";
+  }
+  switch (format.configFormat) {
+    case "xml":
+      return generateXmlConfig(enabledSkills, format);
+    case "mdc":
+      return generateMdcConfig(enabledSkills, format);
+    case "markdown-table":
+      return generateMarkdownTableConfig(enabledSkills, format);
+    case "json":
+      return generateJsonConfig(enabledSkills, format);
+    case "markdown":
+      return generateMarkdownConfig(enabledSkills, format);
+    default:
+      return generateMarkdownConfig(enabledSkills, format);
+  }
+}
+function generateXmlConfig(skills, format) {
+  const skillsXml = skills.map((s) => `<skill>
+<name>${escapeXml(s.name)}</name>
+<description>${escapeXml(s.description)}</description>
+<location>${escapeXml(s.path)}</location>
+</skill>`).join("\n\n");
+  return `<skills_system priority="1">
+
+## Available Skills
+
+<!-- SKILLS_TABLE_START -->
+<usage>
+When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
+
+How to use skills:
+- Invoke: \`${format.invokeCommand} <skill-name>\` or \`npx ${format.invokeCommand} <skill-name>\`
+- The skill content will load with detailed instructions on how to complete the task
+- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
+
+Usage notes:
+- Only use skills listed in <available_skills> below
+- Do not invoke a skill that is already loaded in your context
+- Each skill invocation is stateless
+</usage>
+
+<available_skills>
+
+${skillsXml}
+
+</available_skills>
+<!-- SKILLS_TABLE_END -->
+
+</skills_system>`;
+}
+function generateMdcConfig(skills, format) {
+  const skillsList = skills.map((s) => `- **${s.name}**: ${s.description}`).join("\n");
+  const skillsXml = skills.map((s) => `<skill>
+<name>${escapeXml(s.name)}</name>
+<description>${escapeXml(s.description)}</description>
+<location>${escapeXml(s.path)}</location>
+</skill>`).join("\n\n");
+  return `---
+description: SkillKit skills integration - provides specialized capabilities and domain knowledge
+globs: "**/*"
+alwaysApply: true
+---
+# Skills System
+
+You have access to specialized skills that can help complete tasks. Use the skillkit CLI to load skill instructions when needed.
+
+## Available Skills
+
+${skillsList}
+
+## How to Use Skills
+
+When a task matches a skill's description, load it with:
+\`\`\`bash
+${format.invokeCommand} <skill-name>
+\`\`\`
+
+The skill will provide detailed instructions for completing the task.
+
+<!-- SKILLS_DATA_START -->
+${skillsXml}
+<!-- SKILLS_DATA_END -->
+`;
+}
+function generateMarkdownTableConfig(skills, format) {
+  const skillsList = skills.map((s) => `| ${s.name} | ${s.description} | \`${format.invokeCommand} ${s.name}\` |`).join("\n");
+  return `# Skills
+
+You have access to specialized skills for completing complex tasks.
+
+| Skill | Description | Command |
+|-------|-------------|---------|
+${skillsList}
+
+## Usage
+
+When a task matches a skill's capability, run the command to load detailed instructions:
+
+\`\`\`bash
+${format.invokeCommand} <skill-name>
+\`\`\`
+
+Skills are loaded on-demand to keep context clean. Only load skills when relevant to the current task.
+`;
+}
+function generateJsonConfig(skills, format) {
+  const skillsJson = skills.map((s) => ({
+    name: s.name,
+    description: s.description,
+    invoke: `${format.invokeCommand} ${s.name}`,
+    location: s.path
+  }));
+  return `# Skills Configuration
+
+You have access to specialized skills that extend your capabilities.
+
+## Available Skills
+
+${skills.map((s) => `### ${s.name}
+${s.description}
+
+Invoke: \`${format.invokeCommand} ${s.name}\``).join("\n\n")}
+
+## Skills Data
+
+\`\`\`json
+${JSON.stringify(skillsJson, null, 2)}
+\`\`\`
+
+## Usage Instructions
+
+1. When a task matches a skill's description, load it using the invoke command
+2. Skills provide step-by-step instructions for complex tasks
+3. Each skill is self-contained with its own resources
+`;
+}
+function generateMarkdownConfig(skills, format) {
+  const skillsList = skills.map((s) => `### ${s.name}
+
+${s.description}
+
+**Invoke:** \`${format.invokeCommand} ${s.name}\``).join("\n\n");
+  return `# Skills System
+
+You have access to specialized skills that can help complete tasks.
+
+## Available Skills
+
+${skillsList}
+
+## How to Use Skills
+
+When a task matches a skill's description, load it:
+
+\`\`\`bash
+${format.invokeCommand} <skill-name>
+\`\`\`
+
+Skills provide detailed instructions for completing complex tasks.
+`;
+}
+function escapeXml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+var getAgentSkillsDir = getSkillsDir;
+var getAgentConfigFile = getConfigFile;
 export {
   AGENT_CLI_CONFIGS,
+  AGENT_CONFIG,
   AGENT_DISCOVERY_PATHS,
   AGENT_FORMAT_MAP,
+  AGENT_SKILL_FORMATS,
   AIManager,
   AISearch,
   AISkillGenerator,
@@ -16763,6 +17470,8 @@ export {
   detectSkillFormat,
   discoverAgents,
   discoverAgentsForAgent,
+  discoverAgentsFromPath,
+  discoverAgentsRecursive,
   discoverGlobalAgents,
   discoverSkills,
   dryRunExecutor,
@@ -16781,19 +17490,27 @@ export {
   findSkill,
   formatSkillAsPrompt,
   fromCanonicalAgent,
+  generateSkillsConfig,
   getAgentCLIConfig,
+  getAgentConfigFile,
   getAgentConfigPath,
+  getAgentDirectoryConfig,
   getAgentFilename,
   getAgentFormat,
+  getAgentSkillsDir,
   getAgentStats,
   getAgentTargetDirectory,
   getAgentsDirectory,
   getAllProviders,
+  getAllSkillsDirs,
   getAvailableCLIAgents,
   getBuiltinPacksDir,
   getCICDTemplate,
+  getConfigFile,
+  getConfigFormat,
   getExecutionStrategy,
   getGlobalConfigPath,
+  getGlobalSkillsDir,
   getIndexStatus,
   getInstallDir,
   getManualExecutionInstructions,
@@ -16802,6 +17519,7 @@ export {
   getProjectConfigPath,
   getProvider,
   getSearchDirs,
+  getSkillsDir,
   getStackTags,
   getSupportedTranslationAgents,
   getTechTags,
@@ -16834,6 +17552,8 @@ export {
   parseShorthand,
   parseSkill,
   parseSkillContent,
+  parseSkillContentToCanonical,
+  parseSkillToCanonical,
   parseSource,
   parseWorkflow,
   readAgentContent,
@@ -16847,6 +17567,7 @@ export {
   setSkillEnabled,
   shellExecutor,
   skillMdTranslator,
+  supportsAutoDiscovery,
   supportsSlashCommands,
   syncToAgent,
   syncToAllAgents,
@@ -16857,6 +17578,8 @@ export {
   translateCanonicalAgent,
   translateSkill,
   translateSkillFile,
+  translateSkillToAgent,
+  translateSkillToAll,
   translatorRegistry,
   validateAgent,
   validateBuiltinPacks,
@@ -16867,6 +17590,7 @@ export {
   validateSkillContent,
   validateWorkflow,
   windsurfTranslator,
-  wrapProgressCallbackWithMemory
+  wrapProgressCallbackWithMemory,
+  writeTranslatedSkill
 };
 //# sourceMappingURL=index.js.map