prpm 2.1.15 → 2.1.17

package/dist/format-capabilities.json

@@ -5,7 +5,7 @@
   "lastVerified": "2025-12-06",
   "verificationSources": {
     "claude": "https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview",
-    "copilot": "https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/",
+    "copilot": "https://code.visualstudio.com/docs/copilot/customization/agent-skills",
     "cursor": "https://docs.cursor.com/context/rules",
     "continue": "https://docs.continue.dev/reference",
     "windsurf": "https://docs.codeium.com/windsurf/cascade",
@@ -58,13 +58,13 @@
     },
     "copilot": {
       "name": "GitHub Copilot",
-      "supportsSkills": false,
+      "supportsSkills": true,
       "supportsPlugins": false,
       "supportsExtensions": false,
       "supportsAgents": true,
       "supportsAgentsMd": true,
       "markdownFallback": "copilot-instructions.md",
-      "notes": "GitHub Copilot coding agent supports AGENTS.md, CLAUDE.md, GEMINI.md, and .instructions.md custom instructions (as of August 2025). Full agents.md support."
+      "notes": "GitHub Copilot supports skills in .github/skills/<name>/SKILL.md (VS Code Insiders with chat.useAgentSkills setting). Also supports AGENTS.md, CLAUDE.md, GEMINI.md, and .instructions.md custom instructions."
     },
     "kiro": {
       "name": "Kiro AI",

package/dist/index.js

@@ -8645,6 +8645,96 @@ var init_from_zed = __esm({
   }
 });
 
+// ../converters/dist/from-codex.js
+function parseFrontmatter8(content) {
+  const normalizedContent = content.replace(/\r\n/g, "\n");
+  const match = normalizedContent.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return { frontmatter: {}, body: normalizedContent };
+  }
+  try {
+    const frontmatter = jsYaml.load(match[1]);
+    const body = match[2];
+    return { frontmatter: frontmatter || {}, body };
+  } catch (error) {
+    return { frontmatter: {}, body: normalizedContent };
+  }
+}
+function parseAllowedTools(toolsString) {
+  return toolsString.split(/\s+/).filter(Boolean).map((tool) => {
+    const match = tool.match(/^([A-Za-z]+)(?:\([^)]*\))?$/);
+    return match ? match[1] : tool;
+  }).filter((tool, index, arr) => arr.indexOf(tool) === index);
+}
+function fromCodex(content, metadata) {
+  const { frontmatter, body } = parseFrontmatter8(content);
+  const fm = frontmatter;
+  const sections = [];
+  const metadataSection = {
+    type: "metadata",
+    data: {
+      title: fm.name || metadata.name || metadata.id,
+      description: fm.description || metadata.description || "",
+      version: metadata.version || "1.0.0",
+      author: metadata.author
+    }
+  };
+  metadataSection.data.agentSkills = {
+    name: fm.name,
+    license: fm.license,
+    compatibility: fm.compatibility,
+    allowedTools: fm["allowed-tools"],
+    metadata: fm.metadata
+  };
+  sections.push(metadataSection);
+  if (fm["allowed-tools"]) {
+    const tools = parseAllowedTools(fm["allowed-tools"]);
+    if (tools.length > 0) {
+      const toolsSection = {
+        type: "tools",
+        tools,
+        description: "Pre-approved tools for this skill"
+      };
+      sections.push(toolsSection);
+    }
+  }
+  if (body.trim()) {
+    sections.push({
+      type: "instructions",
+      title: "Instructions",
+      content: body.trim()
+    });
+  }
+  const canonicalContent = {
+    format: "canonical",
+    version: "1.0",
+    sections
+  };
+  const pkg = {
+    ...metadata,
+    id: metadata.id,
+    name: fm.name || metadata.name || metadata.id,
+    version: metadata.version,
+    author: metadata.author,
+    description: fm.description || metadata.description || "",
+    license: fm.license || metadata.license,
+    tags: metadata.tags || [],
+    format: "codex",
+    subtype: "skill",
+    content: canonicalContent
+  };
+  setTaxonomy(pkg, "codex", "skill");
+  return pkg;
+}
+var init_from_codex = __esm({
+  "../converters/dist/from-codex.js"() {
+    "use strict";
+    init_cjs_shims();
+    init_taxonomy_utils();
+    init_js_yaml();
+  }
+});
+
 // ../converters/dist/from-mcp-server.js
 function fromMCPServer(mcpServerJson, metadata) {
   var _a;
@@ -8758,6 +8848,7 @@ function loadSchema(format, subtype) {
       "claude:slash-command": "claude-slash-command.schema.json",
       "claude:hook": "claude-hook.schema.json",
       "claude:plugin": "claude-plugin.schema.json",
+      "copilot:skill": "agent-skills.schema.json",
       "cursor:slash-command": "cursor-command.schema.json",
       "cursor:hook": "cursor-hooks.schema.json",
       // cursor + hook subtype uses cursor-hooks schema
@@ -8768,6 +8859,7 @@ function loadSchema(format, subtype) {
       "droid:hook": "droid-hook.schema.json",
       "opencode:slash-command": "opencode-slash-command.schema.json",
       "opencode:plugin": "opencode-plugin.schema.json",
+      "codex:skill": "agent-skills.schema.json",
       "gemini:extension": "gemini-extension.schema.json",
       "mcp:server": "mcp-server.schema.json"
     };
@@ -9830,7 +9922,11 @@ function toCopilot(pkg, options = {}) {
   let qualityScore = 100;
   try {
     const config = options.copilotConfig || {};
-    const isPathSpecific = !!config.applyTo;
+    const isSkill = config.isSkill || pkg.subtype === "skill";
+    const isPathSpecific = !!config.applyTo && !isSkill;
+    if (isSkill) {
+      return convertToSkill(pkg, config, warnings);
+    }
     if (isPathSpecific && !config.applyTo) {
       warnings.push("Path-specific instruction requires applyTo pattern");
       qualityScore -= 20;
@@ -9838,7 +9934,7 @@ function toCopilot(pkg, options = {}) {
     const content = convertContent3(pkg, warnings, config);
     let fullContent;
     if (isPathSpecific && config.applyTo) {
-      const frontmatter = generateFrontmatter(config);
+      const frontmatter = generateInstructionFrontmatter(config);
       fullContent = `${frontmatter}
 
 ${content}`;
@@ -9867,7 +9963,99 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter(config) {
+function convertToSkill(pkg, config, warnings) {
+  var _a, _b;
+  let qualityScore = 100;
+  const metadataSection = pkg.content.sections.find((s) => s.type === "metadata");
+  const agentSkillsData = (metadataSection == null ? void 0 : metadataSection.type) === "metadata" ? metadataSection.data.agentSkills : void 0;
+  const skillName = (agentSkillsData == null ? void 0 : agentSkillsData.name) || config.skillName || ((_a = pkg.name) == null ? void 0 : _a.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64)) || pkg.id.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64);
+  const skillDescription = config.skillDescription || pkg.description || ((_b = pkg.metadata) == null ? void 0 : _b.description) || "";
+  if (!skillDescription) {
+    warnings.push("Skill requires a description - using empty string");
+    qualityScore -= 20;
+  }
+  if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
+    warnings.push("Skill name should be lowercase alphanumeric with single hyphens (no start/end/consecutive hyphens)");
+    qualityScore -= 10;
+  }
+  const frontmatter = generateSkillFrontmatter(skillName, skillDescription, pkg, agentSkillsData);
+  const content = convertSkillContent(pkg, warnings);
+  const fullContent = `${frontmatter}
+
+${content}`;
+  const lossyConversion = warnings.some((w) => w.includes("not supported") || w.includes("skipped"));
+  if (lossyConversion) {
+    qualityScore -= 10;
+  }
+  return {
+    content: fullContent,
+    format: "copilot",
+    warnings: warnings.length > 0 ? warnings : void 0,
+    lossyConversion,
+    qualityScore
+  };
+}
+function generateSkillFrontmatter(name, description, pkg, agentSkillsData) {
+  const lines = ["---"];
+  lines.push(`name: ${name}`);
+  const truncatedDesc = description.length > 1024 ? description.slice(0, 1021) + "..." : description;
+  const quotedDesc = `"${truncatedDesc.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\r/g, "\\r").replace(/\n/g, "\\n")}"`;
+  lines.push(`description: ${quotedDesc}`);
+  const license = (agentSkillsData == null ? void 0 : agentSkillsData.license) || pkg.license;
+  if (license) {
+    lines.push(`license: ${license}`);
+  }
+  if (agentSkillsData == null ? void 0 : agentSkillsData.compatibility) {
+    lines.push(`compatibility: "${agentSkillsData.compatibility}"`);
+  }
+  if (agentSkillsData == null ? void 0 : agentSkillsData.allowedTools) {
+    lines.push(`allowed-tools: ${agentSkillsData.allowedTools}`);
+  }
+  if ((agentSkillsData == null ? void 0 : agentSkillsData.metadata) && Object.keys(agentSkillsData.metadata).length > 0) {
+    lines.push("metadata:");
+    for (const [key, value] of Object.entries(agentSkillsData.metadata)) {
+      lines.push(`  ${key}: "${value}"`);
+    }
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+function convertSkillContent(pkg, warnings) {
+  var _a, _b, _c, _d;
+  const lines = [];
+  const title = ((_a = pkg.metadata) == null ? void 0 : _a.title) || pkg.name || pkg.id;
+  lines.push(`# ${title}`);
+  lines.push("");
+  if (pkg.description || ((_b = pkg.metadata) == null ? void 0 : _b.description)) {
+    lines.push(pkg.description || ((_c = pkg.metadata) == null ? void 0 : _c.description) || "");
+    lines.push("");
+  }
+  for (const section of pkg.content.sections) {
+    if (section.type === "metadata") {
+      continue;
+    }
+    if (section.type === "tools") {
+      warnings.push("Tools section converted to reference list");
+      continue;
+    }
+    if (section.type === "persona") {
+      if ((_d = section.data) == null ? void 0 : _d.role) {
+        lines.push("## When to Use");
+        lines.push("");
+        lines.push(section.data.role);
+        lines.push("");
+      }
+      continue;
+    }
+    const sectionContent = convertSection4(section, warnings);
+    if (sectionContent) {
+      lines.push(sectionContent);
+      lines.push("");
+    }
+  }
+  return lines.join("\n").trim();
+}
+function generateInstructionFrontmatter(config) {
   const lines = ["---"];
   if (config.applyTo) {
     const patterns = Array.isArray(config.applyTo) ? config.applyTo : [config.applyTo];
@@ -10002,7 +10190,7 @@ function toKiro(pkg, options = {}) {
     if (config.inclusion === "fileMatch" && !config.fileMatchPattern) {
       throw new Error("fileMatch inclusion mode requires fileMatchPattern");
     }
-    const frontmatter = generateFrontmatter2(config);
+    const frontmatter = generateFrontmatter(config);
     const content = convertContent4(pkg, warnings, config);
     const fullContent = `${frontmatter}
 
@@ -10029,7 +10217,7 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter2(config) {
+function generateFrontmatter(config) {
   const lines = ["---"];
   lines.push(`inclusion: ${config.inclusion || "always"}`);
   if (config.inclusion === "fileMatch" && config.fileMatchPattern) {
@@ -11711,7 +11899,7 @@ function toZencoder(pkg, options = {}) {
     const content = convertContent12(pkg, warnings, config);
     let fullContent;
     if (includeFrontmatter) {
-      const frontmatter = generateFrontmatter3(pkg, config);
+      const frontmatter = generateFrontmatter2(pkg, config);
       if (frontmatter) {
         fullContent = `${frontmatter}
 
@@ -11744,7 +11932,7 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter3(pkg, config) {
+function generateFrontmatter2(pkg, config) {
   var _a, _b, _c;
   const lines = [];
   let hasContent = false;
@@ -12218,9 +12406,12 @@ function toCodex(pkg, options = {}) {
   let qualityScore = 100;
   try {
     const config = options.codexConfig || {};
+    const isSkill = pkg.subtype === "skill";
     const isSlashCommand = pkg.subtype === "slash-command";
     let content;
-    if (isSlashCommand) {
+    if (isSkill && !config.forceAgentsMd) {
+      content = convertToSkillMd(pkg, warnings);
+    } else if (isSlashCommand) {
       content = convertSlashCommandToSection(pkg, warnings);
       if (config.appendMode && config.existingContent) {
         content = appendToExistingAgentsMd(config.existingContent, content, pkg.name);
@@ -12250,6 +12441,74 @@ function toCodex(pkg, options = {}) {
     };
   }
 }
+function convertToSkillMd(pkg, warnings) {
+  var _a;
+  const lines = [];
+  const metadataSection = pkg.content.sections.find((s) => s.type === "metadata");
+  const toolsSection = pkg.content.sections.find((s) => s.type === "tools");
+  const title = ((_a = pkg.metadata) == null ? void 0 : _a.title) || pkg.name;
+  const description = pkg.description || "";
+  const frontmatter = {
+    name: slugify(title),
+    description: truncateDescription(description, 1024)
+  };
+  if (pkg.license) {
+    frontmatter.license = pkg.license;
+  }
+  if ((metadataSection == null ? void 0 : metadataSection.type) === "metadata" && metadataSection.data.agentSkills) {
+    const skillsData = metadataSection.data.agentSkills;
+    if (skillsData.name) {
+      frontmatter.name = skillsData.name;
+    }
+    if (skillsData.license) {
+      frontmatter.license = skillsData.license;
+    }
+    if (skillsData.compatibility) {
+      frontmatter.compatibility = skillsData.compatibility;
+    }
+    if (skillsData.allowedTools) {
+      frontmatter["allowed-tools"] = skillsData.allowedTools;
+    }
+    if (skillsData.metadata && Object.keys(skillsData.metadata).length > 0) {
+      frontmatter.metadata = skillsData.metadata;
+    }
+  }
+  if ((toolsSection == null ? void 0 : toolsSection.type) === "tools" && toolsSection.tools.length > 0 && !frontmatter["allowed-tools"]) {
+    frontmatter["allowed-tools"] = toolsSection.tools.join(" ");
+  }
+  lines.push("---");
+  lines.push(jsYaml.dump(frontmatter, { indent: 2, lineWidth: -1 }).trim());
+  lines.push("---");
+  lines.push("");
+  for (const section of pkg.content.sections) {
+    if (section.type === "metadata")
+      continue;
+    if (section.type === "tools")
+      continue;
+    if (section.type === "persona") {
+      warnings.push("Persona section skipped (not supported by Agent Skills format)");
+      continue;
+    }
+    const sectionContent = convertSection13(section, warnings);
+    if (sectionContent) {
+      lines.push(sectionContent);
+      lines.push("");
+    }
+  }
+  return lines.join("\n").trim() + "\n";
+}
+function truncateDescription(desc, maxLength) {
+  if (desc.length <= maxLength)
+    return desc;
+  return desc.substring(0, maxLength - 3) + "...";
+}
+function slugify(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  if (!slug) {
+    return "unnamed-skill";
+  }
+  return slug.slice(0, 64);
+}
 function convertSlashCommandToSection(pkg, warnings) {
   const lines = [];
   const commandName = pkg.name.replace(/^\//, "");
@@ -12340,10 +12599,15 @@ function convertToAgentsMd(pkg, warnings) {
   }
   return lines.join("\n").trim();
 }
+function escapeRegex(str2) {
+  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function appendToExistingAgentsMd(existingContent, newSection, commandName) {
-  const sectionHeader = `## ${commandName.replace(/^\//, "")}`;
+  const cleanCommandName = commandName.replace(/^\//, "");
+  const escapedCommandName = escapeRegex(cleanCommandName);
+  const sectionHeader = `## ${cleanCommandName}`;
   if (existingContent.includes(sectionHeader)) {
-    const regex = new RegExp(`## ${commandName.replace(/^\//, "")}[\\s\\S]*?(?=## |$)`, "g");
+    const regex = new RegExp(`## ${escapedCommandName}[\\s\\S]*?(?=## |$)`, "g");
     return existingContent.replace(regex, newSection + "\n\n");
   }
   const trimmedExisting = existingContent.trim();
@@ -12457,13 +12721,25 @@ function parseArgumentHint2(hint) {
   }
   return hint.split(/\s+/).filter(Boolean);
 }
-function generateFilename2() {
+function generateFilename2(pkg) {
+  if ((pkg == null ? void 0 : pkg.subtype) === "skill") {
+    return "SKILL.md";
+  }
   return "AGENTS.md";
 }
+function isCodexSkillFormat(content) {
+  const normalizedContent = content.replace(/\r\n/g, "\n");
+  const match = normalizedContent.match(/^---\n([\s\S]*?)\n---/);
+  if (!match)
+    return false;
+  const frontmatterText = match[1];
+  return frontmatterText.includes("name:") && frontmatterText.includes("description:");
+}
 var init_to_codex = __esm({
   "../converters/dist/to-codex.js"() {
     "use strict";
     init_cjs_shims();
+    init_js_yaml();
   }
 });
 
@@ -12546,7 +12822,7 @@ var init_to_mcp_server = __esm({
 });
 
 // ../converters/dist/schema-files.js
-var import_module, import_path7, schemaRequire, convertersPackagePath, convertersDir, loadSchema2, formatRegistrySchema, agentsMdSchema, canonicalSchema, claudeSchema, continueSchema, copilotSchema, cursorSchema, droidSchema, geminiMdSchema, geminiSchema, kiroSteeringSchema, opencodeSchema, rulerSchema, windsurfSchema, traeSchema, aiderSchema, zencoderSchema, replitSchema, zedSchema, claudeAgentSchema, claudeHookSchema, claudeSkillSchema, claudeSlashCommandSchema, cursorCommandSchema, cursorHooksSchema, droidHookSchema, droidSkillSchema, droidSlashCommandSchema, kiroAgentSchema, kiroHookSchema, opencodeSlashCommandSchema;
+var import_module, import_path7, schemaRequire, convertersPackagePath, convertersDir, loadSchema2, formatRegistrySchema, agentsMdSchema, canonicalSchema, claudeSchema, continueSchema, copilotSchema, cursorSchema, droidSchema, geminiMdSchema, geminiSchema, kiroSteeringSchema, opencodeSchema, rulerSchema, windsurfSchema, traeSchema, aiderSchema, zencoderSchema, replitSchema, zedSchema, claudeAgentSchema, claudeHookSchema, claudeSkillSchema, claudeSlashCommandSchema, agentSkillsSchema, copilotSkillSchema, codexSkillSchema, cursorCommandSchema, cursorHooksSchema, droidHookSchema, droidSkillSchema, droidSlashCommandSchema, kiroAgentSchema, kiroHookSchema, opencodeSlashCommandSchema;
 var init_schema_files = __esm({
   "../converters/dist/schema-files.js"() {
     "use strict";
@@ -12580,6 +12856,9 @@ var init_schema_files = __esm({
     claudeHookSchema = loadSchema2("claude-hook.schema.json");
     claudeSkillSchema = loadSchema2("claude-skill.schema.json");
     claudeSlashCommandSchema = loadSchema2("claude-slash-command.schema.json");
+    agentSkillsSchema = loadSchema2("agent-skills.schema.json");
+    copilotSkillSchema = agentSkillsSchema;
+    codexSkillSchema = agentSkillsSchema;
     cursorCommandSchema = loadSchema2("cursor-command.schema.json");
     cursorHooksSchema = loadSchema2("cursor-hooks.schema.json");
     droidHookSchema = loadSchema2("droid-hook.schema.json");
@@ -12717,7 +12996,7 @@ var init_format_registry = __esm({
         },
         copilot: {
           name: "GitHub Copilot",
-          description: "GitHub Copilot instructions and chat modes",
+          description: "GitHub Copilot instructions, chat modes, and skills",
           documentationUrl: "https://docs.github.com/en/copilot",
           subtypes: {
             rule: {
@@ -12729,6 +13008,14 @@ var init_format_registry = __esm({
               directory: ".github/chatmodes",
               filePatterns: ["*.chatmode.md"],
               fileExtension: ".chatmode.md"
+            },
+            skill: {
+              directory: ".github/skills",
+              filePatterns: ["SKILL.md"],
+              nested: true,
+              nestedIndicator: "SKILL.md",
+              usesPackageSubdirectory: true,
+              fileExtension: ".md"
             }
           }
         },
@@ -12890,7 +13177,8 @@ var init_format_registry = __esm({
         },
         codex: {
           name: "OpenAI Codex CLI",
-          description: "OpenAI Codex CLI using AGENTS.md for project instructions",
+          description: "OpenAI Codex CLI skills and AGENTS.md project instructions",
+          documentationUrl: "https://developers.openai.com/codex/skills",
           subtypes: {
             rule: {
               directory: ".",
@@ -12903,7 +13191,7 @@ var init_format_registry = __esm({
               fileExtension: ".md"
             },
             skill: {
-              directory: ".openskills",
+              directory: ".codex/skills",
               filePatterns: ["SKILL.md"],
               nested: true,
               nestedIndicator: "SKILL.md",
@@ -13346,6 +13634,7 @@ __export(dist_exports, {
   SCRIPT_LANGUAGE_EXTENSIONS: () => SCRIPT_LANGUAGE_EXTENSIONS,
   VALID_CURSOR_HOOK_TYPES: () => VALID_CURSOR_HOOK_TYPES,
   VALID_HOOK_MAPPING_STRATEGIES: () => VALID_HOOK_MAPPING_STRATEGIES,
+  agentSkillsSchema: () => agentSkillsSchema,
   agentsMdSchema: () => agentsMdSchema,
   aiderSchema: () => aiderSchema,
   canonicalSchema: () => canonicalSchema,
@@ -13354,8 +13643,10 @@ __export(dist_exports, {
   claudeSchema: () => claudeSchema,
   claudeSkillSchema: () => claudeSkillSchema,
   claudeSlashCommandSchema: () => claudeSlashCommandSchema,
+  codexSkillSchema: () => codexSkillSchema,
   continueSchema: () => continueSchema,
   copilotSchema: () => copilotSchema,
+  copilotSkillSchema: () => copilotSkillSchema,
   createMinimalPluginJson: () => createMinimalPluginJson,
   cursorCommandSchema: () => cursorCommandSchema,
   cursorHooksSchema: () => cursorHooksSchema,
@@ -13376,6 +13667,7 @@ __export(dist_exports, {
   fromAider: () => fromAider,
   fromClaude: () => fromClaude,
   fromClaudePlugin: () => fromClaudePlugin,
+  fromCodex: () => fromCodex,
   fromContinue: () => fromContinue,
   fromCopilot: () => fromCopilot,
   fromCursor: () => fromCursor,
@@ -13423,6 +13715,7 @@ __export(dist_exports, {
   isAgentsMdFormat: () => isAgentsMdFormat,
   isAiderFormat: () => isAiderFormat,
   isClaudeFormat: () => isClaudeFormat,
+  isCodexSkillFormat: () => isCodexSkillFormat,
   isContinueFormat: () => isContinueFormat,
   isCopilotFormat: () => isCopilotFormat,
   isCursorFormat: () => isCursorFormat,
@@ -13513,6 +13806,7 @@ var init_dist = __esm({
     init_from_zencoder();
     init_from_replit();
     init_from_zed();
+    init_from_codex();
     init_from_mcp_server();
     init_to_cursor();
     init_to_cursor_hooks();
@@ -17204,6 +17498,8 @@ This could indicate:
         }
       } else if (effectiveFormat === "droid" && effectiveSubtype === "skill") {
         destPath = `${destDir}/SKILL.md`;
+      } else if (effectiveFormat === "copilot" && effectiveSubtype === "skill") {
+        destPath = `${destDir}/SKILL.md`;
       } else {
         const nativeSubtypes2 = import_types.FORMAT_NATIVE_SUBTYPES[effectiveFormat];
         const needsProgressiveDisclosureHere = nativeSubtypes2 && !nativeSubtypes2.includes(effectiveSubtype) && (effectiveSubtype === "skill" || effectiveSubtype === "agent" || effectiveSubtype === "slash-command");
@@ -24820,6 +25116,9 @@ function getDefaultPath(format, filename, subtype, customName) {
     case "droid":
       return (0, import_path23.join)(process.cwd(), ".factory", `${baseName}.md`);
     case "codex":
+      if (subtype === "skill") {
+        return (0, import_path23.join)(process.cwd(), ".codex", "skills", baseName, "SKILL.md");
+      }
       return (0, import_path23.join)(process.cwd(), "AGENTS.md");
     default:
       throw new CLIError(`Unknown format: ${format}`);
@@ -24863,6 +25162,9 @@ function detectFormat(content, filepath) {
   if (filepath.includes(".zed/extensions") || filepath.includes(".zed/slash_commands")) {
     return "zed";
   }
+  if (filepath.includes(".codex/skills") || (0, import_path23.basename)(filepath) === "SKILL.md") {
+    return "codex";
+  }
   if (isCursorHooksFormat(content)) return "cursor-hooks";
   if (isClaudeFormat(content)) {
     if (content.includes("type: skill")) return "claude-skill";
@@ -24878,6 +25180,7 @@ function detectFormat(content, filepath) {
   if (isAgentsMdFormat(content)) return "agents.md";
   if (isRulerFormat(content)) return "ruler";
   if (isZedFormat(content)) return "zed";
+  if (isCodexSkillFormat(content)) return "codex";
   return null;
 }
 async function confirmOverwrite(filepath) {
@@ -24999,6 +25302,9 @@ async function handleConvert(sourcePath, options) {
       case "droid":
         canonicalPkg = fromDroid(content, metadata);
         break;
+      case "codex":
+        canonicalPkg = fromCodex(content, metadata);
+        break;
       default:
         throw new CLIError(`Unsupported source format: ${sourceFormat}`);
     }

package/dist/schemas/agent-skills.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/agent-skills.json",
+  "$comment": "https://agentskills.io/specification",
+  "title": "Agent Skills Format",
+  "description": "JSON Schema for Agent Skills - a shared standard implemented by Codex, GitHub Copilot, and other AI assistants. Skills are SKILL.md files with YAML frontmatter.",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Skill identifier: 1-64 chars, lowercase alphanumeric and hyphens only, cannot start/end with hyphens or contain consecutive hyphens. Must match parent directory name.",
+          "minLength": 1,
+          "maxLength": 64,
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "description": {
+          "type": "string",
+          "description": "Explains what the skill does and when to use it. Should include specific keywords for agent identification. (1-1024 chars)",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "license": {
+          "type": "string",
+          "description": "Specifies skill licensing terms. Keep brief (license name or bundled file reference)."
+        },
+        "compatibility": {
+          "type": "string",
+          "description": "Indicates environment requirements (products, system packages, network access). Example: 'Requires git, docker, jq, and internet access'",
+          "maxLength": 500
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Space-delimited list of pre-approved tools. Experimental; support varies by implementation. Example: 'Bash(git:*) Bash(jq:*) Read'"
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Arbitrary string key-value pairs for additional properties not defined by the specification",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Skill instructions as markdown text. Recommended to keep under 5000 tokens for progressive disclosure."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "code-review",
+        "description": "Reviews code for best practices, security issues, and improvements. Use when analyzing pull requests, code changes, or conducting security audits.",
+        "license": "MIT",
+        "compatibility": "Requires git",
+        "metadata": {
+          "category": "development",
+          "version": "1.0.0"
+        }
+      },
+      "content": "You are an expert code reviewer.\n\n## Instructions\n\n- Check for code smells\n- Verify test coverage\n- Suggest improvements"
+    },
+    {
+      "frontmatter": {
+        "name": "pdf-processing",
+        "description": "Extracts and processes content from PDF documents. Use for document analysis, text extraction, and PDF manipulation tasks.",
+        "allowed-tools": "Bash(pdftotext:*) Read Write"
+      },
+      "content": "Process PDF documents using available command-line tools.\n\n## Capabilities\n\n- Extract text from PDFs\n- Convert PDF pages to images\n- Merge and split PDF files"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "2.1.15",
+  "version": "2.1.17",
   "description": "Prompt Package Manager CLI - Install and manage prompt-based files",
   "main": "dist/index.js",
   "bin": {
@@ -45,9 +45,9 @@
   "license": "MIT",
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "@pr-pm/converters": "^2.1.16",
-    "@pr-pm/registry-client": "^2.3.15",
-    "@pr-pm/types": "^2.1.16",
+    "@pr-pm/converters": "^2.1.18",
+    "@pr-pm/registry-client": "^2.3.17",
+    "@pr-pm/types": "^2.1.18",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",