agentpacks 0.9.0 → 1.0.0

package/dist/exporters/cursor-plugin.js

@@ -129,11 +129,101 @@ function serializeFrontmatter(data, content) {
   return matter.stringify(content, filtered);
 }
 
+// src/features/skills.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2 } 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 (existsSync2(skillMd)) {
+      skills.push(parseSkillFile(skillMd, dir, packName));
+    }
+  }
+  return skills;
+}
+function parseSkillFile(filepath, skillDir, packName) {
+  const raw = readFileSync2(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/hooks.ts
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 var TARGET_OVERRIDE_KEYS = ["cursor", "claudecode", "opencode"];
 function parseHooks(packDir, packName) {
-  const hooksPath = join2(packDir, "hooks", "hooks.json");
+  const hooksPath = join3(packDir, "hooks", "hooks.json");
   const raw = readJsonOrNull(hooksPath);
   if (!raw)
     return null;
@@ -168,7 +258,7 @@ function resolveHooksForTarget(hooks, targetId) {
 }
 
 // src/exporters/cursor-plugin.ts
-import { resolve, join as join3 } from "path";
+import { resolve, join as join4 } from "path";
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
 function exportCursorPlugin(pack, outputDir) {
   const filesWritten = [];
@@ -204,7 +294,7 @@ function exportCursorPlugin(pack, outputDir) {
     manifest.keywords = pack.manifest.tags;
   }
   if (pack.rules.length > 0) {
-    const rulesDir = join3(pluginDir, "rules");
+    const rulesDir = join4(pluginDir, "rules");
     ensureDir(rulesDir);
     manifest.rules = "rules";
     for (const rule of pack.rules) {
@@ -217,13 +307,13 @@ function exportCursorPlugin(pack, outputDir) {
       if (globs)
         fm.globs = globs;
       const filename = `${rule.name}.mdc`;
-      const filepath = join3(rulesDir, filename);
+      const filepath = join4(rulesDir, filename);
       writeFileSync2(filepath, serializeFrontmatter(fm, rule.content));
       filesWritten.push(filepath);
     }
   }
   if (pack.agents.length > 0) {
-    const agentsDir = join3(pluginDir, "agents");
+    const agentsDir = join4(pluginDir, "agents");
     ensureDir(agentsDir);
     manifest.agents = "agents";
     for (const agent of pack.agents) {
@@ -232,29 +322,26 @@ function exportCursorPlugin(pack, outputDir) {
         description: agent.meta.description ?? ""
       };
       const filename = `${agent.name}.md`;
-      const filepath = join3(agentsDir, filename);
+      const filepath = join4(agentsDir, filename);
       writeFileSync2(filepath, serializeFrontmatter(fm, agent.content));
       filesWritten.push(filepath);
     }
   }
   if (pack.skills.length > 0) {
-    const skillsDir = join3(pluginDir, "skills");
+    const skillsDir = join4(pluginDir, "skills");
     ensureDir(skillsDir);
     manifest.skills = "skills";
     for (const skill of pack.skills) {
-      const skillSubDir = join3(skillsDir, skill.name);
+      const skillSubDir = join4(skillsDir, skill.name);
       ensureDir(skillSubDir);
-      const fm = {
-        name: skill.name,
-        description: skill.meta.description ?? ""
-      };
-      const filepath = join3(skillSubDir, "SKILL.md");
-      writeFileSync2(filepath, serializeFrontmatter(fm, skill.content));
+      const filepath = join4(skillSubDir, "SKILL.md");
+      const content = serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+      writeFileSync2(filepath, content);
       filesWritten.push(filepath);
     }
   }
   if (pack.commands.length > 0) {
-    const commandsDir = join3(pluginDir, "commands");
+    const commandsDir = join4(pluginDir, "commands");
     ensureDir(commandsDir);
     manifest.commands = "commands";
     for (const cmd of pack.commands) {
@@ -265,7 +352,7 @@ function exportCursorPlugin(pack, outputDir) {
         fm.description = cmd.meta.description;
       }
       const filename = `${cmd.name}.md`;
-      const filepath = join3(commandsDir, filename);
+      const filepath = join4(commandsDir, filename);
       writeFileSync2(filepath, serializeFrontmatter(fm, cmd.content));
       filesWritten.push(filepath);
     }
@@ -273,9 +360,9 @@ function exportCursorPlugin(pack, outputDir) {
   if (pack.hooks) {
     const events = resolveHooksForTarget(pack.hooks, "cursor");
     if (Object.keys(events).length > 0) {
-      const hooksDir = join3(pluginDir, "hooks");
+      const hooksDir = join4(pluginDir, "hooks");
       ensureDir(hooksDir);
-      const filepath = join3(hooksDir, "hooks.json");
+      const filepath = join4(hooksDir, "hooks.json");
       writeFileSync2(filepath, JSON.stringify({ version: pack.hooks.version ?? 1, hooks: events }, null, 2) + `
 `);
       filesWritten.push(filepath);
@@ -284,14 +371,14 @@ function exportCursorPlugin(pack, outputDir) {
   }
   if (pack.mcp && Object.keys(pack.mcp.servers).length > 0) {
     manifest.mcpServers = ".mcp.json";
-    const filepath = join3(pluginDir, ".mcp.json");
+    const filepath = join4(pluginDir, ".mcp.json");
     writeFileSync2(filepath, JSON.stringify({ mcpServers: pack.mcp.servers }, null, 2) + `
 `);
     filesWritten.push(filepath);
   }
-  const manifestDir = join3(pluginDir, ".cursor-plugin");
+  const manifestDir = join4(pluginDir, ".cursor-plugin");
   ensureDir(manifestDir);
-  const manifestPath = join3(manifestDir, "plugin.json");
+  const manifestPath = join4(manifestDir, "plugin.json");
   writeFileSync2(manifestPath, JSON.stringify(manifest, null, 2) + `
 `);
   filesWritten.push(manifestPath);

package/dist/exporters/index.js

@@ -129,11 +129,101 @@ function serializeFrontmatter(data, content) {
   return matter.stringify(content, filtered);
 }
 
+// src/features/skills.ts
+import { readFileSync as readFileSync2, existsSync as existsSync2 } 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 (existsSync2(skillMd)) {
+      skills.push(parseSkillFile(skillMd, dir, packName));
+    }
+  }
+  return skills;
+}
+function parseSkillFile(filepath, skillDir, packName) {
+  const raw = readFileSync2(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/hooks.ts
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 var TARGET_OVERRIDE_KEYS = ["cursor", "claudecode", "opencode"];
 function parseHooks(packDir, packName) {
-  const hooksPath = join2(packDir, "hooks", "hooks.json");
+  const hooksPath = join3(packDir, "hooks", "hooks.json");
   const raw = readJsonOrNull(hooksPath);
   if (!raw)
     return null;
@@ -168,7 +258,7 @@ function resolveHooksForTarget(hooks, targetId) {
 }
 
 // src/exporters/cursor-plugin.ts
-import { resolve, join as join3 } from "path";
+import { resolve, join as join4 } from "path";
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
 function exportCursorPlugin(pack, outputDir) {
   const filesWritten = [];
@@ -204,7 +294,7 @@ function exportCursorPlugin(pack, outputDir) {
     manifest.keywords = pack.manifest.tags;
   }
   if (pack.rules.length > 0) {
-    const rulesDir = join3(pluginDir, "rules");
+    const rulesDir = join4(pluginDir, "rules");
     ensureDir(rulesDir);
     manifest.rules = "rules";
     for (const rule of pack.rules) {
@@ -217,13 +307,13 @@ function exportCursorPlugin(pack, outputDir) {
       if (globs)
         fm.globs = globs;
       const filename = `${rule.name}.mdc`;
-      const filepath = join3(rulesDir, filename);
+      const filepath = join4(rulesDir, filename);
       writeFileSync2(filepath, serializeFrontmatter(fm, rule.content));
       filesWritten.push(filepath);
     }
   }
   if (pack.agents.length > 0) {
-    const agentsDir = join3(pluginDir, "agents");
+    const agentsDir = join4(pluginDir, "agents");
     ensureDir(agentsDir);
     manifest.agents = "agents";
     for (const agent of pack.agents) {
@@ -232,29 +322,26 @@ function exportCursorPlugin(pack, outputDir) {
         description: agent.meta.description ?? ""
       };
       const filename = `${agent.name}.md`;
-      const filepath = join3(agentsDir, filename);
+      const filepath = join4(agentsDir, filename);
       writeFileSync2(filepath, serializeFrontmatter(fm, agent.content));
       filesWritten.push(filepath);
     }
   }
   if (pack.skills.length > 0) {
-    const skillsDir = join3(pluginDir, "skills");
+    const skillsDir = join4(pluginDir, "skills");
     ensureDir(skillsDir);
     manifest.skills = "skills";
     for (const skill of pack.skills) {
-      const skillSubDir = join3(skillsDir, skill.name);
+      const skillSubDir = join4(skillsDir, skill.name);
       ensureDir(skillSubDir);
-      const fm = {
-        name: skill.name,
-        description: skill.meta.description ?? ""
-      };
-      const filepath = join3(skillSubDir, "SKILL.md");
-      writeFileSync2(filepath, serializeFrontmatter(fm, skill.content));
+      const filepath = join4(skillSubDir, "SKILL.md");
+      const content = serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+      writeFileSync2(filepath, content);
       filesWritten.push(filepath);
     }
   }
   if (pack.commands.length > 0) {
-    const commandsDir = join3(pluginDir, "commands");
+    const commandsDir = join4(pluginDir, "commands");
     ensureDir(commandsDir);
     manifest.commands = "commands";
     for (const cmd of pack.commands) {
@@ -265,7 +352,7 @@ function exportCursorPlugin(pack, outputDir) {
         fm.description = cmd.meta.description;
       }
       const filename = `${cmd.name}.md`;
-      const filepath = join3(commandsDir, filename);
+      const filepath = join4(commandsDir, filename);
       writeFileSync2(filepath, serializeFrontmatter(fm, cmd.content));
       filesWritten.push(filepath);
     }
@@ -273,9 +360,9 @@ function exportCursorPlugin(pack, outputDir) {
   if (pack.hooks) {
     const events = resolveHooksForTarget(pack.hooks, "cursor");
     if (Object.keys(events).length > 0) {
-      const hooksDir = join3(pluginDir, "hooks");
+      const hooksDir = join4(pluginDir, "hooks");
       ensureDir(hooksDir);
-      const filepath = join3(hooksDir, "hooks.json");
+      const filepath = join4(hooksDir, "hooks.json");
       writeFileSync2(filepath, JSON.stringify({ version: pack.hooks.version ?? 1, hooks: events }, null, 2) + `
 `);
       filesWritten.push(filepath);
@@ -284,14 +371,14 @@ function exportCursorPlugin(pack, outputDir) {
   }
   if (pack.mcp && Object.keys(pack.mcp.servers).length > 0) {
     manifest.mcpServers = ".mcp.json";
-    const filepath = join3(pluginDir, ".mcp.json");
+    const filepath = join4(pluginDir, ".mcp.json");
     writeFileSync2(filepath, JSON.stringify({ mcpServers: pack.mcp.servers }, null, 2) + `
 `);
     filesWritten.push(filepath);
   }
-  const manifestDir = join3(pluginDir, ".cursor-plugin");
+  const manifestDir = join4(pluginDir, ".cursor-plugin");
   ensureDir(manifestDir);
-  const manifestPath = join3(manifestDir, "plugin.json");
+  const manifestPath = join4(manifestDir, "plugin.json");
   writeFileSync2(manifestPath, JSON.stringify(manifest, null, 2) + `
 `);
   filesWritten.push(manifestPath);

package/dist/features/index.d.ts

@@ -1,7 +1,7 @@
 export { type ParsedRule, type RuleFrontmatter, parseRules, ruleMatchesTarget, getRootRules, getDetailRules, } from './rules.js';
 export { type ParsedCommand, type CommandFrontmatter, parseCommands, commandMatchesTarget, } from './commands.js';
 export { type ParsedAgent, type AgentFrontmatter, parseAgents, agentMatchesTarget, } from './agents.js';
-export { type ParsedSkill, type SkillFrontmatter, parseSkills, skillMatchesTarget, } from './skills.js';
+export { type ParsedSkill, type SkillFrontmatter, parseSkills, buildSkillFrontmatter, serializeSkill, normalizeImportedSkillMarkdown, validateAgentSkillsFrontmatter, skillMatchesTarget, } from './skills.js';
 export { type ParsedHooks, type HookEvents, type HookEntry, parseHooks, resolveHooksForTarget, } from './hooks.js';
 export { type ParsedPlugin, parsePlugins } from './plugins.js';
 export { type ParsedMcp, type McpServerEntry, parseMcp, mergeMcpConfigs, } from './mcp.js';

package/dist/features/index.js

@@ -219,6 +219,8 @@ function agentMatchesTarget(agent, targetId) {
 // src/features/skills.ts
 import { readFileSync as readFileSync5, existsSync as existsSync2 } 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 = [];
@@ -242,6 +244,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 === "*")
@@ -547,7 +602,9 @@ function scanModelsForSecrets(config) {
   return warnings;
 }
 export {
+  validateAgentSkillsFrontmatter,
   skillMatchesTarget,
+  serializeSkill,
   scanModelsForSecrets,
   ruleMatchesTarget,
   resolveHooksForTarget,
@@ -560,12 +617,14 @@ export {
   parseHooks,
   parseCommands,
   parseAgents,
+  normalizeImportedSkillMarkdown,
   mergeModelsConfigs,
   mergeMcpConfigs,
   mergeIgnorePatterns,
   getRootRules,
   getDetailRules,
   commandMatchesTarget,
+  buildSkillFrontmatter,
   agentMatchesTarget,
   ModelsSchema
 };

package/dist/features/skills.d.ts

@@ -4,6 +4,8 @@
 export interface SkillFrontmatter {
     name?: string;
     description?: string;
+    'allowed-tools'?: string[];
+    compatibility?: unknown;
     targets?: string[] | '*';
     /** Per-target overrides */
     claudecode?: {
@@ -36,6 +38,26 @@ export declare function parseSkills(skillsDir: string, packName: string): Parsed
  * Parse a single SKILL.md file.
  */
 export declare function parseSkillFile(filepath: string, skillDir: string, packName: string): ParsedSkill;
+/**
+ * Build output frontmatter for a SKILL.md file.
+ * Preserves all metadata while ensuring `name` exists.
+ */
+export declare function buildSkillFrontmatter(skill: ParsedSkill): Record<string, unknown>;
+/**
+ * Serialize a parsed skill back to SKILL.md format.
+ */
+export declare function serializeSkill(skill: ParsedSkill): string;
+/**
+ * Normalize imported SKILL.md content to AgentSkills-compatible minimum metadata.
+ */
+export declare function normalizeImportedSkillMarkdown(source: string, skillName: string): {
+    content: string;
+    addedDescription: boolean;
+};
+/**
+ * Validate AgentSkills frontmatter requirements for a parsed skill.
+ */
+export declare function validateAgentSkillsFrontmatter(skill: ParsedSkill): string[];
 /**
  * Check if a skill targets a specific tool.
  */

package/dist/features/skills.js

@@ -132,6 +132,8 @@ function serializeFrontmatter(data, content) {
 // src/features/skills.ts
 import { readFileSync as readFileSync2, existsSync as existsSync2 } 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 = [];
@@ -155,6 +157,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 = 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 === "*")
@@ -164,7 +219,11 @@ function skillMatchesTarget(skill, targetId) {
   return Array.isArray(targets) && targets.includes(targetId);
 }
 export {
+  validateAgentSkillsFrontmatter,
   skillMatchesTarget,
+  serializeSkill,
   parseSkills,
-  parseSkillFile
+  parseSkillFile,
+  normalizeImportedSkillMarkdown,
+  buildSkillFrontmatter
 };