prpm 2.1.30 → 2.1.31

package/dist/format-capabilities.json

@@ -18,13 +18,13 @@
     "cursor": {
       "name": "Cursor",
       "supportsSkills": false,
-      "supportsPlugins": false,
+      "supportsPlugins": true,
       "supportsExtensions": false,
       "supportsAgents": false,
       "supportsAgentsMd": true,
       "supportsSlashCommands": true,
       "markdownFallback": "cursor-rules.md",
-      "notes": "Cursor supports AGENTS.md files for project instructions. Custom slash commands in .cursor/commands/*.md (introduced v1.6, Sept 2025). Built-in /summarize command. Rules are appended automatically, slash commands are explicit prompts with more weight. No native agent/skill/plugin packages."
+      "notes": "Cursor supports plugins (.cursor-plugin/plugin.json) that bundle rules, skills, agents, commands, hooks, and MCP servers. Custom slash commands in .cursor/commands/*.md. AGENTS.md for project instructions. Plugin marketplace at cursor.com/marketplace. No native standalone agent/skill packages."
     },
     "claude": {
       "name": "Claude Code",

package/dist/index.js

@@ -1500,6 +1500,114 @@ var init_from_claude_plugin = __esm({
   }
 });
 
+// ../converters/dist/from-cursor-plugin.js
+function fromCursorPlugin(pluginJson, contents, metadata) {
+  var _a, _b, _c, _d;
+  const sections = [];
+  const authorStr = pluginJson.author ? pluginJson.author.email ? `${pluginJson.author.name} <${pluginJson.author.email}>` : pluginJson.author.name : metadata.author;
+  const mcpServers = typeof pluginJson.mcpServers === "object" && !Array.isArray(pluginJson.mcpServers) ? pluginJson.mcpServers : void 0;
+  const metadataSection = {
+    type: "metadata",
+    data: {
+      title: pluginJson.name || metadata.name,
+      description: pluginJson.description || "",
+      version: pluginJson.version || metadata.version || "1.0.0",
+      author: authorStr,
+      cursorPlugin: {
+        logo: pluginJson.logo,
+        mcpServers,
+        contents: {
+          rules: contents.rules || [],
+          agents: contents.agents || [],
+          skills: contents.skills || [],
+          commands: contents.commands || [],
+          hooks: contents.hooks
+        }
+      }
+    }
+  };
+  sections.push(metadataSection);
+  if (pluginJson.description) {
+    sections.push({
+      type: "instructions",
+      title: "Overview",
+      content: pluginJson.description
+    });
+  }
+  const contentsSummary = [];
+  if ((_a = contents.rules) == null ? void 0 : _a.length) {
+    contentsSummary.push(`- **Rules**: ${contents.rules.length} rules`);
+  }
+  if ((_b = contents.agents) == null ? void 0 : _b.length) {
+    contentsSummary.push(`- **Agents**: ${contents.agents.length} agents`);
+  }
+  if ((_c = contents.skills) == null ? void 0 : _c.length) {
+    contentsSummary.push(`- **Skills**: ${contents.skills.length} skills`);
+  }
+  if ((_d = contents.commands) == null ? void 0 : _d.length) {
+    contentsSummary.push(`- **Commands**: ${contents.commands.length} commands`);
+  }
+  if (contents.hooks) {
+    contentsSummary.push(`- **Hooks**: configured`);
+  }
+  if (mcpServers && Object.keys(mcpServers).length > 0) {
+    contentsSummary.push(`- **MCP Servers**: ${Object.keys(mcpServers).join(", ")}`);
+  }
+  if (contentsSummary.length > 0) {
+    sections.push({
+      type: "context",
+      title: "Plugin Contents",
+      content: contentsSummary.join("\n")
+    });
+  }
+  const pkg = {
+    id: metadata.id,
+    version: pluginJson.version || metadata.version || "1.0.0",
+    name: pluginJson.name || metadata.name,
+    description: pluginJson.description || "",
+    author: authorStr || "unknown",
+    tags: pluginJson.keywords || metadata.tags || [],
+    license: pluginJson.license || metadata.license,
+    repository: pluginJson.repository || metadata.repository,
+    homepage: pluginJson.homepage || metadata.homepage,
+    content: {
+      format: "canonical",
+      version: "1.0",
+      sections
+    },
+    sourceFormat: "cursor",
+    metadata: {
+      title: metadataSection.data.title,
+      description: metadataSection.data.description,
+      version: metadataSection.data.version,
+      author: metadataSection.data.author,
+      cursorPlugin: metadataSection.data.cursorPlugin
+    }
+  };
+  setTaxonomy(pkg, "cursor", "plugin");
+  return pkg;
+}
+function parseCursorPluginJson(content) {
+  try {
+    return JSON.parse(content);
+  } catch (error) {
+    throw new Error(`Failed to parse plugin.json: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+function extractCursorMCPServers(pluginJson) {
+  if (typeof pluginJson.mcpServers === "object" && !Array.isArray(pluginJson.mcpServers)) {
+    return pluginJson.mcpServers;
+  }
+  return {};
+}
+var init_from_cursor_plugin = __esm({
+  "../converters/dist/from-cursor-plugin.js"() {
+    "use strict";
+    init_cjs_shims();
+    init_taxonomy_utils();
+  }
+});
+
 // ../converters/dist/from-continue.js
 function fromContinue(content, metadata, explicitSubtype) {
   const pkg = fromClaude(content, metadata, "continue", explicitSubtype);
@@ -8771,7 +8879,7 @@ function fromCodex(content, metadata) {
   return pkg;
 }
 function fromCodexAgentRole(content, metadata) {
-  var _a;
+  var _a, _b;
   let role = {};
   try {
     role = import_toml.default.parse(content);
@@ -8781,8 +8889,8 @@ function fromCodexAgentRole(content, metadata) {
   const metadataSection = {
     type: "metadata",
     data: {
-      title: metadata.name || metadata.id,
-      description: metadata.description || "",
+      title: role.name || metadata.name || metadata.id,
+      description: role.description || metadata.description || "",
       version: metadata.version || "1.0.0",
       author: metadata.author
     }
@@ -8790,10 +8898,15 @@ function fromCodexAgentRole(content, metadata) {
   metadataSection.data.codexAgent = {
     model: role.model,
     modelReasoningEffort: role.model_reasoning_effort,
-    sandboxMode: role.sandbox_mode
+    sandboxMode: role.sandbox_mode,
+    name: role.name,
+    description: role.description,
+    nicknameCandidates: role.nickname_candidates,
+    mcpServers: role.mcp_servers,
+    skillsConfig: (_a = role.skills) == null ? void 0 : _a.config
   };
   sections.push(metadataSection);
-  if ((_a = role.developer_instructions) == null ? void 0 : _a.trim()) {
+  if ((_b = role.developer_instructions) == null ? void 0 : _b.trim()) {
     sections.push({
       type: "instructions",
       title: "Instructions",
@@ -8808,10 +8921,10 @@ function fromCodexAgentRole(content, metadata) {
   const pkg = {
     ...metadata,
     id: metadata.id,
-    name: metadata.name || metadata.id,
+    name: role.name || metadata.name || metadata.id,
     version: metadata.version,
     author: metadata.author,
-    description: metadata.description || "",
+    description: role.description || metadata.description || "",
     tags: metadata.tags || [],
     format: "codex",
     subtype: "agent",
@@ -9033,6 +9146,7 @@ function loadSchema(format, subtype) {
       "cursor:slash-command": "cursor-command.schema.json",
       "cursor:hook": "cursor-hooks.schema.json",
       // cursor + hook subtype uses cursor-hooks schema
+      "cursor:plugin": "cursor-plugin.schema.json",
       "kiro:hook": "kiro-hook.schema.json",
       "kiro:agent": "kiro-agent.schema.json",
       "droid:skill": "droid-skill.schema.json",
@@ -9942,6 +10056,110 @@ var init_to_claude_plugin = __esm({
   }
 });
 
+// ../converters/dist/to-cursor-plugin.js
+function toCursorPlugin(pkg) {
+  var _a, _b, _c, _d;
+  const warnings = [];
+  let qualityScore = 100;
+  try {
+    const metadata = pkg.content.sections.find((s) => s.type === "metadata");
+    const storedPluginData = (metadata == null ? void 0 : metadata.type) === "metadata" ? metadata.data.cursorPlugin : void 0;
+    const pluginJson = {
+      name: pkg.name || pkg.id
+    };
+    if (pkg.description || (metadata == null ? void 0 : metadata.type) === "metadata" && metadata.data.description) {
+      pluginJson.description = pkg.description || ((metadata == null ? void 0 : metadata.type) === "metadata" ? metadata.data.description : "");
+    }
+    if (pkg.version) {
+      pluginJson.version = pkg.version;
+    }
+    if (pkg.author) {
+      const emailMatch = pkg.author.match(/^(.+?)\s*<(.+?)>$/);
+      if (emailMatch) {
+        pluginJson.author = { name: emailMatch[1].trim(), email: emailMatch[2] };
+      } else {
+        pluginJson.author = { name: pkg.author };
+      }
+    }
+    if (pkg.homepage) {
+      pluginJson.homepage = pkg.homepage;
+    }
+    if (pkg.repository) {
+      pluginJson.repository = pkg.repository;
+    }
+    if (pkg.license) {
+      pluginJson.license = pkg.license;
+    }
+    if (pkg.tags && pkg.tags.length > 0) {
+      pluginJson.keywords = pkg.tags;
+    }
+    if (storedPluginData == null ? void 0 : storedPluginData.logo) {
+      pluginJson.logo = storedPluginData.logo;
+    }
+    if ((storedPluginData == null ? void 0 : storedPluginData.mcpServers) && Object.keys(storedPluginData.mcpServers).length > 0) {
+      pluginJson.mcpServers = storedPluginData.mcpServers;
+    }
+    const pluginContents = (storedPluginData == null ? void 0 : storedPluginData.contents) || {
+      rules: [],
+      agents: [],
+      skills: [],
+      commands: []
+    };
+    const content = JSON.stringify(pluginJson, null, 2);
+    if (!pluginJson.description) {
+      warnings.push("Missing description");
+      qualityScore -= 5;
+    }
+    const mcpServerCount = (storedPluginData == null ? void 0 : storedPluginData.mcpServers) ? Object.keys(storedPluginData.mcpServers).length : 0;
+    if (mcpServerCount === 0) {
+      warnings.push("No MCP servers configured");
+    }
+    const totalFiles = (((_a = pluginContents.rules) == null ? void 0 : _a.length) || 0) + (((_b = pluginContents.agents) == null ? void 0 : _b.length) || 0) + (((_c = pluginContents.skills) == null ? void 0 : _c.length) || 0) + (((_d = pluginContents.commands) == null ? void 0 : _d.length) || 0) + (pluginContents.hooks ? 1 : 0);
+    if (totalFiles === 0 && mcpServerCount === 0) {
+      warnings.push("Plugin has no rules, agents, skills, commands, hooks, or MCP servers");
+      qualityScore -= 20;
+    }
+    return {
+      content,
+      format: "cursor",
+      warnings: warnings.length > 0 ? warnings : void 0,
+      lossyConversion: false,
+      qualityScore: Math.max(0, qualityScore),
+      pluginJson,
+      pluginContents
+    };
+  } catch (error) {
+    warnings.push(`Conversion error: ${error instanceof Error ? error.message : String(error)}`);
+    return {
+      content: "{}",
+      format: "cursor",
+      warnings,
+      lossyConversion: true,
+      qualityScore: 0,
+      pluginJson: { name: pkg.name || pkg.id },
+      pluginContents: {}
+    };
+  }
+}
+function generateCursorPluginJson(pluginJson) {
+  return JSON.stringify(pluginJson, null, 2);
+}
+function createMinimalCursorPluginJson(name, options) {
+  return {
+    name,
+    version: (options == null ? void 0 : options.version) || "1.0.0",
+    description: options == null ? void 0 : options.description,
+    author: options == null ? void 0 : options.author,
+    mcpServers: options == null ? void 0 : options.mcpServers
+  };
+}
+var init_to_cursor_plugin = __esm({
+  "../converters/dist/to-cursor-plugin.js"() {
+    "use strict";
+    init_cjs_shims();
+  }
+});
+
 // ../converters/dist/to-continue.js
 function toContinue(pkg) {
   var _a, _b;
@@ -12635,7 +12853,7 @@ function toCodex(pkg, options = {}) {
     const isSlashCommand = pkg.subtype === "slash-command";
     let content;
     if (isSkill && !config.forceAgentsMd) {
-      content = convertToSkillMd(pkg, warnings);
+      content = convertToSkillMd(pkg, warnings, config);
     } else if (isAgent) {
       content = convertToAgentRoleToml(pkg, warnings);
     } else if (isSlashCommand) {
@@ -12673,6 +12891,18 @@ function convertToAgentRoleToml(pkg, warnings) {
   const instructionsSection = pkg.content.sections.find((s) => s.type === "instructions");
   const role = {};
   const codexAgent = (metadataSection == null ? void 0 : metadataSection.type) === "metadata" ? metadataSection.data.codexAgent : void 0;
+  const agentName = (codexAgent == null ? void 0 : codexAgent.name) || pkg.name;
+  role["name"] = agentName;
+  const agentDescription = (codexAgent == null ? void 0 : codexAgent.description) || ((metadataSection == null ? void 0 : metadataSection.type) === "metadata" ? metadataSection.data.description : "") || pkg.description || "";
+  role["description"] = agentDescription;
+  if ((instructionsSection == null ? void 0 : instructionsSection.type) === "instructions") {
+    role["developer_instructions"] = instructionsSection.content;
+  } else if (pkg.description) {
+    role["developer_instructions"] = pkg.description;
+  }
+  if ((codexAgent == null ? void 0 : codexAgent.nicknameCandidates) && codexAgent.nicknameCandidates.length > 0) {
+    role["nickname_candidates"] = codexAgent.nicknameCandidates;
+  }
   if (codexAgent == null ? void 0 : codexAgent.model) {
     role["model"] = codexAgent.model;
   }
@@ -12682,10 +12912,11 @@ function convertToAgentRoleToml(pkg, warnings) {
   if (codexAgent == null ? void 0 : codexAgent.sandboxMode) {
     role["sandbox_mode"] = codexAgent.sandboxMode;
   }
-  if ((instructionsSection == null ? void 0 : instructionsSection.type) === "instructions") {
-    role["developer_instructions"] = instructionsSection.content;
-  } else if (pkg.description) {
-    role["developer_instructions"] = pkg.description;
+  if ((codexAgent == null ? void 0 : codexAgent.mcpServers) && Object.keys(codexAgent.mcpServers).length > 0) {
+    role["mcp_servers"] = codexAgent.mcpServers;
+  }
+  if ((codexAgent == null ? void 0 : codexAgent.skillsConfig) && Object.keys(codexAgent.skillsConfig).length > 0) {
+    role["skills"] = { config: codexAgent.skillsConfig };
   }
   for (const section of pkg.content.sections) {
     if (section.type === "tools") {
@@ -12698,7 +12929,7 @@ function convertToAgentRoleToml(pkg, warnings) {
   }
   return import_toml2.default.stringify(role);
 }
-function convertToSkillMd(pkg, warnings) {
+function convertToSkillMd(pkg, warnings, config) {
   const lines = [];
   const metadataSection = pkg.content.sections.find((s) => s.type === "metadata");
   const toolsSection = pkg.content.sections.find((s) => s.type === "tools");
@@ -12731,6 +12962,9 @@ function convertToSkillMd(pkg, warnings) {
   if ((toolsSection == null ? void 0 : toolsSection.type) === "tools" && toolsSection.tools.length > 0 && !frontmatter["allowed-tools"]) {
     frontmatter["allowed-tools"] = toolsSection.tools.join(" ");
   }
+  if (config == null ? void 0 : config.allowedTools) {
+    frontmatter["allowed-tools"] = normalizeAllowedTools(config.allowedTools);
+  }
   lines.push("---");
   lines.push(jsYaml.dump(frontmatter, { indent: 2, lineWidth: -1 }).trim());
   lines.push("---");
@@ -12757,6 +12991,9 @@ function truncateDescription(desc, maxLength) {
     return desc;
   return desc.substring(0, maxLength - 3) + "...";
 }
+function normalizeAllowedTools(tools) {
+  return tools.split(/[,\s]+/).map((tool) => tool.trim()).filter(Boolean).join(" ");
+}
 function stripNamespace(name) {
   return name.replace(/^@[^/]+\//, "");
 }
@@ -13291,6 +13528,11 @@ var init_format_registry = __esm({
               directory: ".cursor/commands",
               filePatterns: ["*.md"],
               fileExtension: ".md"
+            },
+            plugin: {
+              directory: ".cursor-plugin",
+              filePatterns: ["plugin.json"],
+              fileExtension: ".json"
             }
           }
         },
@@ -13912,8 +14154,9 @@ function formatSupportsSubtype2(format, subtype) {
     case "skill":
       return capabilities.supportsSkills || false;
     case "plugin":
+      return capabilities.supportsPlugins || false;
     case "extension":
-      return capabilities.supportsPlugins || capabilities.supportsExtensions || false;
+      return capabilities.supportsExtensions || false;
     case "agent":
       return capabilities.supportsAgents || false;
     default:
@@ -14357,6 +14600,7 @@ __export(dist_exports, {
   continueSchema: () => continueSchema,
   copilotSchema: () => copilotSchema,
   copilotSkillSchema: () => copilotSkillSchema,
+  createMinimalCursorPluginJson: () => createMinimalCursorPluginJson,
   createMinimalPluginJson: () => createMinimalPluginJson,
   cursorCommandSchema: () => cursorCommandSchema,
   cursorHooksSchema: () => cursorHooksSchema,
@@ -14366,6 +14610,7 @@ __export(dist_exports, {
   droidSchema: () => droidSchema,
   droidSkillSchema: () => droidSkillSchema,
   droidSlashCommandSchema: () => droidSlashCommandSchema,
+  extractCursorMCPServers: () => extractCursorMCPServers,
   extractMCPServers: () => extractMCPServers,
   extractMCPServersFromCanonical: () => extractMCPServers2,
   findFormatByRootFile: () => findFormatByRootFile,
@@ -14384,6 +14629,7 @@ __export(dist_exports, {
   fromCopilot: () => fromCopilot,
   fromCursor: () => fromCursor,
   fromCursorHooks: () => fromCursorHooks,
+  fromCursorPlugin: () => fromCursorPlugin,
   fromDroid: () => fromDroid,
   fromGemini: () => fromGemini,
   fromGeminiPlugin: () => fromGeminiPlugin,
@@ -14402,6 +14648,7 @@ __export(dist_exports, {
   geminiToClaudeMCP: () => geminiToClaudeMCP,
   geminiToKiroMCP: () => geminiToKiroMCP,
   generateCodexFilename: () => generateFilename2,
+  generateCursorPluginJson: () => generateCursorPluginJson,
   generateMCPServerPackage: () => generateMCPServerPackage,
   generatePluginJson: () => generatePluginJson,
   generateZedFilename: () => generateFilename,
@@ -14457,6 +14704,7 @@ __export(dist_exports, {
   normalizeFormat: () => normalizeFormat,
   opencodeSchema: () => opencodeSchema,
   opencodeSlashCommandSchema: () => opencodeSlashCommandSchema,
+  parseCursorPluginJson: () => parseCursorPluginJson,
   parseMCPServerJson: () => parseMCPServerJson,
   parsePluginJson: () => parsePluginJson,
   replitSchema: () => replitSchema,
@@ -14476,6 +14724,7 @@ __export(dist_exports, {
   toCopilot: () => toCopilot,
   toCursor: () => toCursor,
   toCursorHooks: () => toCursorHooks,
+  toCursorPlugin: () => toCursorPlugin,
   toDroid: () => toDroid,
   toGemini: () => toGemini,
   toGeminiPlugin: () => toGeminiPlugin,
@@ -14511,6 +14760,7 @@ var init_dist = __esm({
     init_from_cursor_hooks();
     init_from_claude();
     init_from_claude_plugin();
+    init_from_cursor_plugin();
     init_from_continue();
     init_from_copilot();
     init_from_kiro();
@@ -14534,6 +14784,7 @@ var init_dist = __esm({
     init_to_cursor_hooks();
     init_to_claude();
     init_to_claude_plugin();
+    init_to_cursor_plugin();
     init_to_continue();
     init_to_copilot();
     init_to_kiro();
@@ -17350,6 +17601,43 @@ function getPackageIcon2(format, subtype) {
   };
   return subtypeIcons[subtype] || formatIcons[format] || "\u{1F4E6}";
 }
+function hasConfigValues(config) {
+  return Boolean(config.tools || config.model);
+}
+function normalizeAllowedTools2(tools) {
+  return tools.split(/[,\s]+/).map((tool) => tool.trim()).filter(Boolean).join(" ");
+}
+function normalizeToolsForClaude(tools) {
+  if (tools.includes(",")) {
+    return tools.split(",").map((t) => t.trim()).filter(Boolean).join(", ");
+  }
+  const parsed = tools.match(/[^\s,()]+(?:\([^)]*\))?/g) || [];
+  return parsed.map((t) => t.trim()).filter(Boolean).join(", ");
+}
+function applyAgentSkillsTools(content, tools) {
+  if (!content.startsWith("---\n")) {
+    return content;
+  }
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return content;
+  }
+  const [, frontmatterText, body] = match;
+  const lines = frontmatterText.split("\n");
+  const normalizedTools = normalizeAllowedTools2(tools);
+  const allowedToolsIndex = lines.findIndex((line) => line.startsWith("allowed-tools:"));
+  if (allowedToolsIndex >= 0) {
+    lines[allowedToolsIndex] = `allowed-tools: ${normalizedTools}`;
+  } else {
+    const descriptionIndex = lines.findIndex((line) => line.startsWith("description:"));
+    const insertAt = descriptionIndex >= 0 ? descriptionIndex + 1 : lines.length;
+    lines.splice(insertAt, 0, `allowed-tools: ${normalizedTools}`);
+  }
+  return `---
+${lines.join("\n")}
+---
+${body}`;
+}
 function getPackageLabel2(format, subtype) {
   const formatLabels = {
     "claude": "Claude",
@@ -17716,10 +18004,10 @@ This could indicate:
       try {
         switch (sourceFormat) {
           case "cursor":
-            canonicalPkg = fromCursor(sourceContent, metadata);
+            canonicalPkg = fromCursor(sourceContent, metadata, pkg.subtype);
             break;
           case "claude":
-            canonicalPkg = fromClaude(sourceContent, metadata);
+            canonicalPkg = fromClaude(sourceContent, metadata, "claude", pkg.subtype);
             break;
           case "windsurf":
             canonicalPkg = fromWindsurf(sourceContent, metadata);
@@ -17751,6 +18039,10 @@ This could indicate:
       }
       let convertedContent;
       const targetFormat2 = format == null ? void 0 : format.toLowerCase();
+      const effectiveClaudeConfig = {
+        ...config.claude,
+        ...options.tools ? { tools: normalizeToolsForClaude(options.tools) } : {}
+      };
       try {
         switch (targetFormat2) {
           case "cursor":
@@ -17766,7 +18058,7 @@ This could indicate:
             break;
           case "claude":
           case "claude.md":
-            const claudeResult = toClaude(canonicalPkg);
+            const claudeResult = toClaude(canonicalPkg, hasConfigValues(effectiveClaudeConfig) ? { claudeConfig: effectiveClaudeConfig } : {});
             convertedContent = claudeResult.content;
             break;
           case "continue":
@@ -17826,7 +18118,7 @@ This could indicate:
             convertedContent = toReplit(canonicalPkg).content;
             break;
           case "codex":
-            convertedContent = toCodex(canonicalPkg).content;
+            convertedContent = toCodex(canonicalPkg, options.tools ? { codexConfig: { allowedTools: options.tools } } : {}).content;
             break;
           case "generic":
             convertedContent = toCursor(canonicalPkg).content;
@@ -18158,11 +18450,19 @@ This could indicate:
         }
       }
       if (format === "claude" && hasClaudeHeader(mainFile)) {
-        if (config.claude) {
+        const effectiveClaudeConfig = {
+          ...config.claude,
+          ...options.tools ? { tools: normalizeToolsForClaude(options.tools) } : {}
+        };
+        if (hasConfigValues(effectiveClaudeConfig)) {
           console.log(`   \u2699\uFE0F  Applying Claude agent config...`);
-          mainFile = applyClaudeConfig(mainFile, config.claude);
+          mainFile = applyClaudeConfig(mainFile, effectiveClaudeConfig);
         }
       }
+      if (effectiveFormat === "codex" && effectiveSubtype === "skill" && options.tools) {
+        console.log(`   \u2699\uFE0F  Applying Codex skill tools override...`);
+        mainFile = applyAgentSkillsTools(mainFile, options.tools);
+      }
       if (effectiveFormat === "claude" && effectiveSubtype === "hook") {
         destPath = destPath || `${destDir}/settings.json`;
         let hookConfig;
@@ -18294,6 +18594,10 @@ This could indicate:
             fileName = fileName.split("/").pop() || fileName;
           }
         }
+        if (effectiveFormat === "codex" && effectiveSubtype === "skill" && options.tools && (fileName === "SKILL.md" || fileName.endsWith("/SKILL.md"))) {
+          console.log(`   \u2699\uFE0F  Applying Codex skill tools override (multi-file)...`);
+          fileContent = applyAgentSkillsTools(fileContent, options.tools);
+        }
         const filePath = `${packageDir}/${fileName}`;
         await saveFile(filePath, fileContent);
         fileCount++;
@@ -18647,7 +18951,7 @@ async function installFromLockfile(options) {
 }
 function createInstallCommand() {
   const command = new import_commander12.Command("install");
-  command.description("Install a package from the registry, or install all packages from prpm.lock if no package specified").argument("[package]", "Package to install (e.g., react-rules or react-rules@1.2.0). If omitted, installs all packages from prpm.lock").option("--version <version>", "Specific version to install").option("--as <format>", `Convert and install in specific format (${import_types.FORMATS.join(", ")})`).option("--format <format>", "Alias for --as").option("--location <path>", "Custom location for installed files (Agents.md or nested Cursor rules)").option("--subtype <subtype>", "Specify subtype when converting (skill, agent, rule, etc.)").option("--hook-mapping <strategy>", "Hook mapping strategy: auto (default), strict, skip", "auto").option("--frozen-lockfile", "Fail if lock file needs to be updated (for CI)").option("-y, --yes", "Auto-confirm prompts (overwrite files without asking)").option("--no-append", "Skip adding skill to manifest file (skill files only)").option("--manifest-file <filename>", "Custom manifest filename for progressive disclosure").option("--eager", "Force skill/agent to always activate (not on-demand)").option("--lazy", "Use default on-demand activation (overrides package eager setting)").option("--global", "Install MCP servers to global config (e.g., ~/.claude/settings.json, ~/.codex/config.toml, ~/.cursor/mcp.json, ~/.kiro/settings/mcp.json)").option("--editor <editor>", "[Deprecated: use --as] Target editor for MCP server installation").action(async (packageSpec, options) => {
+  command.description("Install a package from the registry, or install all packages from prpm.lock if no package specified").argument("[package]", "Package to install (e.g., react-rules or react-rules@1.2.0). If omitted, installs all packages from prpm.lock").option("--version <version>", "Specific version to install").option("--as <format>", `Convert and install in specific format (${import_types.FORMATS.join(", ")})`).option("--format <format>", "Alias for --as").option("--location <path>", "Custom location for installed files (Agents.md or nested Cursor rules)").option("--subtype <subtype>", "Specify subtype when converting (skill, agent, rule, etc.)").option("--hook-mapping <strategy>", "Hook mapping strategy: auto (default), strict, skip", "auto").option("--frozen-lockfile", "Fail if lock file needs to be updated (for CI)").option("-y, --yes", "Auto-confirm prompts (overwrite files without asking)").option("--no-append", "Skip adding skill to manifest file (skill files only)").option("--manifest-file <filename>", "Custom manifest filename for progressive disclosure").option("--eager", "Force skill/agent to always activate (not on-demand)").option("--lazy", "Use default on-demand activation (overrides package eager setting)").option("--tools <tools>", "Override Claude/Codex tool list for this install (comma- or space-separated)").option("--global", "Install MCP servers to global config (e.g., ~/.claude/settings.json, ~/.codex/config.toml, ~/.cursor/mcp.json, ~/.kiro/settings/mcp.json)").option("--editor <editor>", "[Deprecated: use --as] Target editor for MCP server installation").action(async (packageSpec, options) => {
     const rawAs = options.format || options.as;
     const validFormats = import_types.FORMATS;
     const isMCPEditorOnly = rawAs && !validFormats.includes(rawAs) && MCP_EDITORS.includes(rawAs);
@@ -18694,6 +18998,9 @@ Valid strategies: ${VALID_HOOK_MAPPING_STRATEGIES.join(", ")}`
       );
     }
     if (!packageSpec) {
+      if (options.tools) {
+        console.warn("\u26A0\uFE0F  --tools is ignored when installing from prpm.lock (no package specified)");
+      }
       await installFromLockfile({
         as: convertTo,
         subtype: options.subtype,
@@ -18715,6 +19022,7 @@ Valid strategies: ${VALID_HOOK_MAPPING_STRATEGIES.join(", ")}`
       manifestFile: options.manifestFile,
       hookMapping: options.hookMapping,
       eager,
+      tools: options.tools,
       global: options.global,
       editor: mcpEditor
     });

package/dist/schemas/claude-hook-config.schema.json

@@ -0,0 +1,353 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/hook-config.json",
+  "$comment": "https://code.claude.com/docs/en/hooks",
+  "title": "Claude Hook Configuration",
+  "description": "JSON Schema for Claude Code hook.json configuration files. Defines hooks that execute on specific events.",
+  "type": "object",
+  "properties": {
+    "description": {
+      "type": "string",
+      "description": "Optional description of this hook configuration"
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Hook event configurations",
+      "properties": {
+        "PreToolUse": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires after Claude creates tool parameters, before processing. Exit 2 blocks the tool call."
+        },
+        "PermissionRequest": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when user is shown a permission dialog. Exit 2 denies permission."
+        },
+        "PostToolUse": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires immediately after a tool completes successfully. Cannot block (tool already ran)."
+        },
+        "Notification": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when Claude Code sends notifications. Matcher matches notification_type."
+        },
+        "UserPromptSubmit": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when user submits a prompt, before Claude processes it. Exit 2 blocks and erases prompt."
+        },
+        "Stop": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when main Claude Code agent finishes responding. Exit 2 blocks stoppage."
+        },
+        "SubagentStop": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when a Claude Code subagent (Task tool) finishes. Exit 2 blocks stoppage."
+        },
+        "PreCompact": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires before Claude Code runs a compact operation."
+        },
+        "SessionStart": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when Claude Code starts or resumes a session."
+        },
+        "SessionEnd": {
+          "$ref": "#/$defs/hookEventConfig",
+          "description": "Fires when a Claude Code session ends."
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["hooks"],
+  "$defs": {
+    "hookEventConfig": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "matcher": {
+            "type": "string",
+            "description": "Pattern to match tool names (PreToolUse/PostToolUse), notification types (Notification), etc. Use regex patterns like 'Write|Edit' or wildcards like '*'. Empty string matches all."
+          },
+          "hooks": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/hookDefinition"
+            },
+            "description": "Array of hooks to execute when matcher matches"
+          }
+        },
+        "required": ["hooks"]
+      }
+    },
+    "hookDefinition": {
+      "type": "object",
+      "oneOf": [
+        {
+          "properties": {
+            "type": {
+              "const": "command",
+              "description": "Command hook - executes a bash command"
+            },
+            "command": {
+              "type": "string",
+              "description": "Bash command to execute. Use ${CLAUDE_PLUGIN_ROOT} for plugin-relative paths."
+            },
+            "timeout": {
+              "type": "number",
+              "default": 60,
+              "description": "Timeout in seconds (default: 60)"
+            }
+          },
+          "required": ["type", "command"]
+        },
+        {
+          "properties": {
+            "type": {
+              "const": "prompt",
+              "description": "Prompt hook - uses LLM reasoning (Stop/SubagentStop events only)"
+            },
+            "prompt": {
+              "type": "string",
+              "description": "LLM prompt text. Use $ARGUMENTS placeholder for context. Response must be { ok: boolean, reason: string }."
+            },
+            "timeout": {
+              "type": "number",
+              "default": 30,
+              "description": "Timeout in seconds (default: 30)"
+            }
+          },
+          "required": ["type", "prompt"]
+        }
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["command", "prompt"],
+          "description": "Hook type"
+        },
+        "timeout": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 300,
+          "description": "Timeout in seconds"
+        },
+        "once": {
+          "type": "boolean",
+          "default": false,
+          "description": "Run only once per session (skills/slash commands only)"
+        },
+        "systemMessage": {
+          "type": "string",
+          "description": "Message shown to user when hook executes"
+        }
+      }
+    },
+    "hookInput": {
+      "type": "object",
+      "description": "JSON structure sent to hooks via stdin",
+      "properties": {
+        "session_id": {
+          "type": "string",
+          "description": "Current session identifier"
+        },
+        "transcript_path": {
+          "type": "string",
+          "description": "Path to session transcript file"
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Current working directory"
+        },
+        "permission_mode": {
+          "type": "string",
+          "enum": ["default", "plan", "acceptEdits", "dontAsk", "bypassPermissions"],
+          "description": "Current permission mode"
+        },
+        "hook_event_name": {
+          "type": "string",
+          "enum": ["PreToolUse", "PermissionRequest", "PostToolUse", "Notification", "UserPromptSubmit", "Stop", "SubagentStop", "PreCompact", "SessionStart", "SessionEnd"],
+          "description": "Name of the hook event"
+        },
+        "tool_name": {
+          "type": "string",
+          "description": "Name of the tool (PreToolUse/PostToolUse only)"
+        },
+        "tool_input": {
+          "type": "object",
+          "description": "Input parameters for the tool (PreToolUse/PostToolUse only)"
+        },
+        "tool_use_id": {
+          "type": "string",
+          "description": "Unique identifier for this tool use (PreToolUse/PostToolUse only)"
+        },
+        "tool_response": {
+          "type": "object",
+          "description": "Response from the tool (PostToolUse only)"
+        },
+        "message": {
+          "type": "string",
+          "description": "Notification message (Notification only)"
+        },
+        "notification_type": {
+          "type": "string",
+          "enum": ["permission_prompt", "idle_prompt", "auth_success", "elicitation_dialog"],
+          "description": "Type of notification (Notification only)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "User's prompt text (UserPromptSubmit only)"
+        },
+        "stop_hook_active": {
+          "type": "boolean",
+          "description": "Whether stop hook is active (Stop/SubagentStop only)"
+        },
+        "trigger": {
+          "type": "string",
+          "enum": ["manual", "auto"],
+          "description": "What triggered the compact (PreCompact only)"
+        },
+        "custom_instructions": {
+          "type": "string",
+          "description": "Custom instructions for compact (PreCompact only)"
+        },
+        "source": {
+          "type": "string",
+          "enum": ["startup", "resume", "clear", "compact"],
+          "description": "How the session started (SessionStart only)"
+        },
+        "reason": {
+          "type": "string",
+          "enum": ["clear", "logout", "prompt_input_exit", "other"],
+          "description": "Why the session ended (SessionEnd only)"
+        }
+      }
+    },
+    "hookOutput": {
+      "type": "object",
+      "description": "JSON structure hooks can output via stdout (exit code 0 only)",
+      "properties": {
+        "continue": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether Claude should continue after hook"
+        },
+        "stopReason": {
+          "type": "string",
+          "description": "Message when continue is false"
+        },
+        "suppressOutput": {
+          "type": "boolean",
+          "default": false,
+          "description": "Hide stdout from transcript"
+        },
+        "systemMessage": {
+          "type": "string",
+          "description": "Warning message to show user"
+        },
+        "decision": {
+          "type": "string",
+          "enum": ["block"],
+          "description": "Set to 'block' to block the operation"
+        },
+        "reason": {
+          "type": "string",
+          "description": "Reason for the decision"
+        },
+        "hookSpecificOutput": {
+          "type": "object",
+          "description": "Event-specific output fields",
+          "properties": {
+            "hookEventName": {
+              "type": "string"
+            },
+            "permissionDecision": {
+              "type": "string",
+              "enum": ["allow", "deny", "ask"],
+              "description": "PreToolUse: permission decision"
+            },
+            "permissionDecisionReason": {
+              "type": "string",
+              "description": "PreToolUse: reason for decision"
+            },
+            "updatedInput": {
+              "type": "object",
+              "description": "PreToolUse/PermissionRequest: modified tool input"
+            },
+            "additionalContext": {
+              "type": "string",
+              "description": "Additional context to add"
+            }
+          }
+        }
+      }
+    },
+    "promptHookResponse": {
+      "type": "object",
+      "description": "Response format for prompt-based hooks",
+      "properties": {
+        "ok": {
+          "type": "boolean",
+          "description": "Whether the check passed"
+        },
+        "reason": {
+          "type": "string",
+          "description": "Explanation (required when ok is false)"
+        }
+      },
+      "required": ["ok"]
+    }
+  },
+  "examples": [
+    {
+      "description": "Format files on save",
+      "hooks": {
+        "PostToolUse": [
+          {
+            "matcher": "Write|Edit",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format.sh",
+                "timeout": 5
+              }
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "description": "Block sensitive file access",
+      "hooks": {
+        "PreToolUse": [
+          {
+            "matcher": "Write|Edit|Read",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "${CLAUDE_PLUGIN_ROOT}/scripts/block-sensitive.sh"
+              }
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "description": "Verify task completion",
+      "hooks": {
+        "Stop": [
+          {
+            "matcher": "*",
+            "hooks": [
+              {
+                "type": "prompt",
+                "prompt": "Verify all requested tasks were completed. $ARGUMENTS",
+                "timeout": 30
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/dist/schemas/codex-agent-role.schema.json

@@ -1,10 +1,28 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://registry.prpm.dev/api/v1/schemas/codex/agent-role.json",
-  "title": "Codex Agent Role Format",
-  "description": "JSON Schema for OpenAI Codex CLI agent role configuration (TOML format, installed to ~/.codex/agents/)",
+  "title": "Codex Agent Role / Subagent Format",
+  "description": "JSON Schema for OpenAI Codex CLI agent role and subagent configuration (TOML format, installed to ~/.codex/agents/ or .codex/agents/)",
   "type": "object",
+  "required": ["name", "description", "developer_instructions"],
   "properties": {
+    "name": {
+      "type": "string",
+      "description": "Display name of the agent/subagent"
+    },
+    "description": {
+      "type": "string",
+      "description": "Short description of what this agent does and when to use it"
+    },
+    "developer_instructions": {
+      "type": "string",
+      "description": "System prompt / developer instructions for this agent role"
+    },
+    "nickname_candidates": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Alternative names the agent can be referred to as"
+    },
     "model": {
       "type": "string",
       "description": "Model identifier to use for this agent role"
@@ -14,14 +32,40 @@
       "enum": ["low", "medium", "high"],
       "description": "Reasoning effort level for the model"
     },
-    "developer_instructions": {
-      "type": "string",
-      "description": "System prompt / developer instructions for this agent role"
-    },
     "sandbox_mode": {
       "type": "string",
       "enum": ["read-only", "workspace-write", "danger-full-access"],
       "description": "Filesystem/network sandbox policy: read-only (default), workspace-write, or danger-full-access (no sandbox)"
+    },
+    "mcp_servers": {
+      "type": "object",
+      "description": "MCP server configurations available to this agent",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "command": { "type": "string" },
+          "args": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          }
+        }
+      }
+    },
+    "skills": {
+      "type": "object",
+      "description": "Skills configuration for this agent",
+      "properties": {
+        "config": {
+          "type": "object",
+          "description": "Skill-specific configuration key-value pairs",
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
     }
   },
   "additionalProperties": false

package/dist/schemas/cursor-plugin.schema.json

@@ -0,0 +1,169 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/cursor-plugin.json",
+  "$comment": "https://cursor.com/docs/plugins/building",
+  "title": "Cursor Plugin Format",
+  "description": "JSON Schema for Cursor plugins - bundles of rules, skills, agents, commands, hooks, and MCP server configurations",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Plugin identifier (lowercase, kebab-case with alphanumerics, hyphens, and periods)",
+      "pattern": "^[a-z0-9][a-z0-9.-]*[a-z0-9]$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief explanation of plugin functionality"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version (e.g., '1.0.0')",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$"
+    },
+    "author": {
+      "type": "object",
+      "description": "Plugin author information",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Author name"
+        },
+        "email": {
+          "type": "string",
+          "format": "email",
+          "description": "Author email address"
+        }
+      },
+      "additionalProperties": false
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "Plugin homepage URL"
+    },
+    "repository": {
+      "type": "string",
+      "format": "uri",
+      "description": "Repository URL"
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier (e.g., 'MIT', 'Apache-2.0')"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Keywords for discovery and categorization"
+    },
+    "logo": {
+      "type": "string",
+      "description": "Relative path to SVG logo or absolute URL"
+    },
+    "rules": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ],
+      "description": "Path(s) to rule files or directories"
+    },
+    "agents": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ],
+      "description": "Path(s) to agent files or directories"
+    },
+    "skills": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ],
+      "description": "Path(s) to skill directories"
+    },
+    "commands": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "array", "items": { "type": "string" } }
+      ],
+      "description": "Path(s) to command files or directories"
+    },
+    "hooks": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "hooks": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": ["command"],
+                  "properties": {
+                    "command": { "type": "string" },
+                    "matcher": { "type": "string" }
+                  }
+                }
+              }
+            }
+          }
+        }
+      ],
+      "description": "Path to hooks.json or inline hooks configuration"
+    },
+    "mcpServers": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "description": "MCP server configurations",
+          "additionalProperties": {
+            "type": "object",
+            "required": ["command"],
+            "properties": {
+              "command": {
+                "type": "string",
+                "description": "Command to run the MCP server"
+              },
+              "args": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Arguments for the command"
+              },
+              "env": {
+                "type": "object",
+                "additionalProperties": { "type": "string" },
+                "description": "Environment variables"
+              }
+            }
+          }
+        },
+        {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      ],
+      "description": "Path to .mcp.json, inline MCP config, or array of paths"
+    }
+  },
+  "examples": [
+    {
+      "name": "my-cursor-plugin",
+      "description": "A plugin with rules, agents, and MCP servers",
+      "version": "1.0.0",
+      "author": { "name": "Jane Doe", "email": "jane@example.com" },
+      "keywords": ["typescript", "testing"],
+      "mcpServers": {
+        "playwright": {
+          "command": "npx",
+          "args": ["-y", "@playwright/mcp@latest"]
+        }
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "2.1.30",
+  "version": "2.1.31",
   "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.31",
-    "@pr-pm/registry-client": "^2.3.30",
-    "@pr-pm/types": "^2.1.31",
+    "@pr-pm/converters": "^2.1.32",
+    "@pr-pm/registry-client": "^2.3.31",
+    "@pr-pm/types": "^2.1.32",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "chalk": "^5.6.2",