agentpacks 0.9.0 → 1.0.0

package/dist/cli/pack/list.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",
@@ -351,6 +352,8 @@ function agentMatchesTarget(agent, targetId) {
 // src/features/skills.ts
 import { readFileSync as readFileSync6, existsSync as existsSync3 } from "fs";
 import { basename as basename4, join as join2 } from "path";
+var SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var SKILL_NAME_MAX_LENGTH = 64;
 function parseSkills(skillsDir, packName) {
   const dirs = listDirs(skillsDir);
   const skills = [];
@@ -374,6 +377,59 @@ function parseSkillFile(filepath, skillDir, packName) {
     content
   };
 }
+function buildSkillFrontmatter(skill) {
+  return {
+    ...skill.meta,
+    name: skill.name
+  };
+}
+function serializeSkill(skill) {
+  return serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+}
+function normalizeImportedSkillMarkdown(source, skillName) {
+  const { data, content } = parseFrontmatter(source);
+  const normalized = {
+    ...data,
+    name: skillName
+  };
+  let addedDescription = false;
+  const description = normalized.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    normalized.description = `Imported skill: ${skillName}`;
+    addedDescription = true;
+  }
+  return {
+    content: serializeFrontmatter(normalized, content),
+    addedDescription
+  };
+}
+function validateAgentSkillsFrontmatter(skill) {
+  const errors = [];
+  const dirName = basename4(skill.sourceDir);
+  const declaredName = skill.meta.name;
+  if (typeof declaredName !== "string" || declaredName.trim().length === 0) {
+    errors.push('Missing required frontmatter field "name".');
+  } else {
+    if (declaredName.length > SKILL_NAME_MAX_LENGTH) {
+      errors.push(`Invalid "name": must be at most ${SKILL_NAME_MAX_LENGTH} characters.`);
+    }
+    if (!SKILL_NAME_PATTERN.test(declaredName)) {
+      errors.push('Invalid "name": use lowercase letters, numbers, and single hyphens only.');
+    }
+    if (declaredName !== dirName) {
+      errors.push(`Invalid "name": must match containing directory "${dirName}".`);
+    }
+  }
+  const description = skill.meta.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    errors.push('Missing required frontmatter field "description".');
+  }
+  const allowedTools = skill.meta["allowed-tools"];
+  if (allowedTools !== undefined && (!Array.isArray(allowedTools) || allowedTools.some((tool) => typeof tool !== "string" || tool.length === 0))) {
+    errors.push('Invalid "allowed-tools": expected an array of non-empty strings.');
+  }
+  return errors;
+}
 function skillMatchesTarget(skill, targetId) {
   const { targets } = skill.meta;
   if (!targets || targets === "*")

package/dist/cli/pack/validate.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",
@@ -243,8 +244,116 @@ function getHeader(type) {
   }
 }
 
+// src/utils/frontmatter.ts
+import matter from "gray-matter";
+function parseFrontmatter(source) {
+  const { data, content } = matter(source);
+  return {
+    data,
+    content: content.trim(),
+    raw: source
+  };
+}
+function serializeFrontmatter(data, content) {
+  const filtered = Object.fromEntries(Object.entries(data).filter(([, v]) => v !== undefined));
+  if (Object.keys(filtered).length === 0) {
+    return content;
+  }
+  return matter.stringify(content, filtered);
+}
+
+// src/features/skills.ts
+import { readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
+import { basename, join as join2 } from "path";
+var SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var SKILL_NAME_MAX_LENGTH = 64;
+function parseSkills(skillsDir, packName) {
+  const dirs = listDirs(skillsDir);
+  const skills = [];
+  for (const dir of dirs) {
+    const skillMd = join2(dir, "SKILL.md");
+    if (existsSync3(skillMd)) {
+      skills.push(parseSkillFile(skillMd, dir, packName));
+    }
+  }
+  return skills;
+}
+function parseSkillFile(filepath, skillDir, packName) {
+  const raw = readFileSync3(filepath, "utf-8");
+  const { data, content } = parseFrontmatter(raw);
+  return {
+    name: data.name ?? basename(skillDir),
+    sourcePath: filepath,
+    sourceDir: skillDir,
+    packName,
+    meta: data,
+    content
+  };
+}
+function buildSkillFrontmatter(skill) {
+  return {
+    ...skill.meta,
+    name: skill.name
+  };
+}
+function serializeSkill(skill) {
+  return serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+}
+function normalizeImportedSkillMarkdown(source, skillName) {
+  const { data, content } = parseFrontmatter(source);
+  const normalized = {
+    ...data,
+    name: skillName
+  };
+  let addedDescription = false;
+  const description = normalized.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    normalized.description = `Imported skill: ${skillName}`;
+    addedDescription = true;
+  }
+  return {
+    content: serializeFrontmatter(normalized, content),
+    addedDescription
+  };
+}
+function validateAgentSkillsFrontmatter(skill) {
+  const errors = [];
+  const dirName = basename(skill.sourceDir);
+  const declaredName = skill.meta.name;
+  if (typeof declaredName !== "string" || declaredName.trim().length === 0) {
+    errors.push('Missing required frontmatter field "name".');
+  } else {
+    if (declaredName.length > SKILL_NAME_MAX_LENGTH) {
+      errors.push(`Invalid "name": must be at most ${SKILL_NAME_MAX_LENGTH} characters.`);
+    }
+    if (!SKILL_NAME_PATTERN.test(declaredName)) {
+      errors.push('Invalid "name": use lowercase letters, numbers, and single hyphens only.');
+    }
+    if (declaredName !== dirName) {
+      errors.push(`Invalid "name": must match containing directory "${dirName}".`);
+    }
+  }
+  const description = skill.meta.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    errors.push('Missing required frontmatter field "description".');
+  }
+  const allowedTools = skill.meta["allowed-tools"];
+  if (allowedTools !== undefined && (!Array.isArray(allowedTools) || allowedTools.some((tool) => typeof tool !== "string" || tool.length === 0))) {
+    errors.push('Invalid "allowed-tools": expected an array of non-empty strings.');
+  }
+  return errors;
+}
+function skillMatchesTarget(skill, targetId) {
+  const { targets } = skill.meta;
+  if (!targets || targets === "*")
+    return true;
+  if (Array.isArray(targets) && targets.includes("*"))
+    return true;
+  return Array.isArray(targets) && targets.includes(targetId);
+}
+
 // src/features/models.ts
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import { z as z2 } from "zod";
 var SECRET_PATTERNS = [
   /["']api[_-]?key["']\s*:/i,
@@ -304,7 +413,7 @@ var ModelsSchema = z2.object({
   })).optional()
 });
 function parseModels(packDir, packName) {
-  const modelsPath = join2(packDir, "models.json");
+  const modelsPath = join3(packDir, "models.json");
   const raw = readJsonOrNull(modelsPath);
   if (!raw)
     return null;
@@ -413,8 +522,8 @@ function scanModelsForSecrets(config) {
 }
 
 // src/cli/pack/validate.ts
-import { existsSync as existsSync3 } from "fs";
-import { resolve as resolve2, join as join3 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { resolve as resolve2, join as join4, basename as basename2 } from "path";
 import chalk from "chalk";
 function runPackValidate(projectRoot) {
   const config = loadWorkspaceConfig(projectRoot);
@@ -423,13 +532,13 @@ function runPackValidate(projectRoot) {
     const packDir = resolvePackDir(projectRoot, packRef);
     console.log(chalk.bold(`
 Validating pack: ${packRef}`));
-    if (!packDir || !existsSync3(packDir)) {
+    if (!packDir || !existsSync4(packDir)) {
       console.log(chalk.red(`  ERROR: Pack directory not found: ${packRef}`));
       hasErrors = true;
       continue;
     }
     const packJsonPath = resolve2(packDir, "pack.json");
-    if (!existsSync3(packJsonPath)) {
+    if (!existsSync4(packJsonPath)) {
       console.log(chalk.yellow("  warn: No pack.json found. Name will be inferred from directory."));
     } else {
       try {
@@ -443,14 +552,30 @@ Validating pack: ${packRef}`));
     }
     const subdirs = ["rules", "commands", "agents", "skills"];
     for (const sub of subdirs) {
-      const subDir = join3(packDir, sub);
-      if (existsSync3(subDir)) {
+      const subDir = join4(packDir, sub);
+      if (existsSync4(subDir)) {
         if (sub === "skills") {
           const skillDirs = listDirs(subDir);
           for (const skillDir of skillDirs) {
-            const skillMd = join3(skillDir, "SKILL.md");
-            if (!existsSync3(skillMd)) {
-              console.log(chalk.yellow(`  warn: skills/${skillDir.split("/").pop()} missing SKILL.md`));
+            const skillName = basename2(skillDir);
+            const skillMd = join4(skillDir, "SKILL.md");
+            if (!existsSync4(skillMd)) {
+              console.log(chalk.yellow(`  warn: skills/${skillName} missing SKILL.md`));
+              continue;
+            }
+            try {
+              const parsed = parseSkillFile(skillMd, skillDir, "__validation__");
+              const skillErrors = validateAgentSkillsFrontmatter(parsed);
+              for (const err of skillErrors) {
+                console.log(chalk.red(`  ERROR skills/${skillName}/SKILL.md: ${err}`));
+              }
+              if (skillErrors.length > 0) {
+                hasErrors = true;
+              }
+            } catch (err) {
+              const message = err instanceof Error ? err.message : String(err);
+              console.log(chalk.red(`  ERROR skills/${skillName}/SKILL.md: failed to parse (${message})`));
+              hasErrors = true;
             }
           }
           console.log(chalk.green(`  ${sub}/: ${skillDirs.length} skill(s)`));
@@ -462,24 +587,24 @@ Validating pack: ${packRef}`));
     }
     const optionalFiles = ["mcp.json", "ignore", ".aiignore"];
     for (const file of optionalFiles) {
-      if (existsSync3(join3(packDir, file))) {
+      if (existsSync4(join4(packDir, file))) {
         console.log(chalk.green(`  ${file}: present`));
       }
     }
-    const hooksJson = join3(packDir, "hooks", "hooks.json");
-    if (existsSync3(hooksJson)) {
+    const hooksJson = join4(packDir, "hooks", "hooks.json");
+    if (existsSync4(hooksJson)) {
       console.log(chalk.green("  hooks/hooks.json: present"));
     }
-    const pluginsDir = join3(packDir, "plugins");
-    if (existsSync3(pluginsDir)) {
+    const pluginsDir = join4(packDir, "plugins");
+    if (existsSync4(pluginsDir)) {
       const pluginFiles = [
         ...listFiles(pluginsDir, { extension: ".ts" }),
         ...listFiles(pluginsDir, { extension: ".js" })
       ];
       console.log(chalk.green(`  plugins/: ${pluginFiles.length} file(s)`));
     }
-    const modelsJsonPath = join3(packDir, "models.json");
-    if (existsSync3(modelsJsonPath)) {
+    const modelsJsonPath = join4(packDir, "models.json");
+    if (existsSync4(modelsJsonPath)) {
       try {
         const parsed = parseModels(packDir, "validate");
         if (parsed) {

package/dist/cli/publish.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",

package/dist/core/config.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 /**
  * All supported target identifiers.
  */
-export declare const TARGET_IDS: readonly ["opencode", "cursor", "claudecode", "codexcli", "geminicli", "copilot", "agentsmd", "cline", "kilo", "roo", "qwencode", "kiro", "factorydroid", "antigravity", "junie", "augmentcode", "windsurf", "warp", "replit", "zed"];
+export declare const TARGET_IDS: readonly ["opencode", "cursor", "claudecode", "codexcli", "mistralvibe", "geminicli", "copilot", "agentsmd", "cline", "kilo", "roo", "qwencode", "kiro", "factorydroid", "antigravity", "junie", "augmentcode", "windsurf", "warp", "replit", "zed"];
 export type TargetId = (typeof TARGET_IDS)[number];
 /**
  * All supported feature types.

package/dist/core/config.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",

package/dist/core/index.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",
@@ -351,6 +352,8 @@ function agentMatchesTarget(agent, targetId) {
 // src/features/skills.ts
 import { readFileSync as readFileSync6, existsSync as existsSync3 } from "fs";
 import { basename as basename4, join as join2 } from "path";
+var SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var SKILL_NAME_MAX_LENGTH = 64;
 function parseSkills(skillsDir, packName) {
   const dirs = listDirs(skillsDir);
   const skills = [];
@@ -374,6 +377,59 @@ function parseSkillFile(filepath, skillDir, packName) {
     content
   };
 }
+function buildSkillFrontmatter(skill) {
+  return {
+    ...skill.meta,
+    name: skill.name
+  };
+}
+function serializeSkill(skill) {
+  return serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+}
+function normalizeImportedSkillMarkdown(source, skillName) {
+  const { data, content } = parseFrontmatter(source);
+  const normalized = {
+    ...data,
+    name: skillName
+  };
+  let addedDescription = false;
+  const description = normalized.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    normalized.description = `Imported skill: ${skillName}`;
+    addedDescription = true;
+  }
+  return {
+    content: serializeFrontmatter(normalized, content),
+    addedDescription
+  };
+}
+function validateAgentSkillsFrontmatter(skill) {
+  const errors = [];
+  const dirName = basename4(skill.sourceDir);
+  const declaredName = skill.meta.name;
+  if (typeof declaredName !== "string" || declaredName.trim().length === 0) {
+    errors.push('Missing required frontmatter field "name".');
+  } else {
+    if (declaredName.length > SKILL_NAME_MAX_LENGTH) {
+      errors.push(`Invalid "name": must be at most ${SKILL_NAME_MAX_LENGTH} characters.`);
+    }
+    if (!SKILL_NAME_PATTERN.test(declaredName)) {
+      errors.push('Invalid "name": use lowercase letters, numbers, and single hyphens only.');
+    }
+    if (declaredName !== dirName) {
+      errors.push(`Invalid "name": must match containing directory "${dirName}".`);
+    }
+  }
+  const description = skill.meta.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    errors.push('Missing required frontmatter field "description".');
+  }
+  const allowedTools = skill.meta["allowed-tools"];
+  if (allowedTools !== undefined && (!Array.isArray(allowedTools) || allowedTools.some((tool) => typeof tool !== "string" || tool.length === 0))) {
+    errors.push('Invalid "allowed-tools": expected an array of non-empty strings.');
+  }
+  return errors;
+}
 function skillMatchesTarget(skill, targetId) {
   const { targets } = skill.meta;
   if (!targets || targets === "*")

package/dist/core/metarepo.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",

package/dist/core/pack-loader.js

@@ -11,6 +11,7 @@ var TARGET_IDS = [
   "cursor",
   "claudecode",
   "codexcli",
+  "mistralvibe",
   "geminicli",
   "copilot",
   "agentsmd",
@@ -351,6 +352,8 @@ function agentMatchesTarget(agent, targetId) {
 // src/features/skills.ts
 import { readFileSync as readFileSync6, existsSync as existsSync3 } from "fs";
 import { basename as basename4, join as join2 } from "path";
+var SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var SKILL_NAME_MAX_LENGTH = 64;
 function parseSkills(skillsDir, packName) {
   const dirs = listDirs(skillsDir);
   const skills = [];
@@ -374,6 +377,59 @@ function parseSkillFile(filepath, skillDir, packName) {
     content
   };
 }
+function buildSkillFrontmatter(skill) {
+  return {
+    ...skill.meta,
+    name: skill.name
+  };
+}
+function serializeSkill(skill) {
+  return serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+}
+function normalizeImportedSkillMarkdown(source, skillName) {
+  const { data, content } = parseFrontmatter(source);
+  const normalized = {
+    ...data,
+    name: skillName
+  };
+  let addedDescription = false;
+  const description = normalized.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    normalized.description = `Imported skill: ${skillName}`;
+    addedDescription = true;
+  }
+  return {
+    content: serializeFrontmatter(normalized, content),
+    addedDescription
+  };
+}
+function validateAgentSkillsFrontmatter(skill) {
+  const errors = [];
+  const dirName = basename4(skill.sourceDir);
+  const declaredName = skill.meta.name;
+  if (typeof declaredName !== "string" || declaredName.trim().length === 0) {
+    errors.push('Missing required frontmatter field "name".');
+  } else {
+    if (declaredName.length > SKILL_NAME_MAX_LENGTH) {
+      errors.push(`Invalid "name": must be at most ${SKILL_NAME_MAX_LENGTH} characters.`);
+    }
+    if (!SKILL_NAME_PATTERN.test(declaredName)) {
+      errors.push('Invalid "name": use lowercase letters, numbers, and single hyphens only.');
+    }
+    if (declaredName !== dirName) {
+      errors.push(`Invalid "name": must match containing directory "${dirName}".`);
+    }
+  }
+  const description = skill.meta.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    errors.push('Missing required frontmatter field "description".');
+  }
+  const allowedTools = skill.meta["allowed-tools"];
+  if (allowedTools !== undefined && (!Array.isArray(allowedTools) || allowedTools.some((tool) => typeof tool !== "string" || tool.length === 0))) {
+    errors.push('Invalid "allowed-tools": expected an array of non-empty strings.');
+  }
+  return errors;
+}
 function skillMatchesTarget(skill, targetId) {
   const { targets } = skill.meta;
   if (!targets || targets === "*")