prpm 1.1.7 → 1.1.8

package/dist/index.js

@@ -3211,7 +3211,7 @@ function fromClaude(content, metadata, sourceFormat = "claude", explicitSubtype)
     }
   };
   sections.push(metadataSection);
-  const toolsField = frontmatter["allowed-tools"] || frontmatter.tools;
+  const toolsField = frontmatter.tools || frontmatter["allowed-tools"];
   if (toolsField) {
     const tools = toolsField.split(",").map((t) => t.trim()).filter(Boolean);
     if (tools.length > 0) {
@@ -9382,7 +9382,11 @@ function loadSchema(format, subtype) {
       "claude:hook": "claude-hook.schema.json",
       "cursor:slash-command": "cursor-command.schema.json",
       "kiro:hook": "kiro-hooks.schema.json",
-      "kiro:agent": "kiro-agent.schema.json"
+      "kiro:agent": "kiro-agent.schema.json",
+      "droid:skill": "droid-skill.schema.json",
+      "droid:slash-command": "droid-slash-command.schema.json",
+      "droid:hook": "droid-hook.schema.json",
+      "opencode:slash-command": "opencode-slash-command.schema.json"
     };
     schemaFilename = subtypeSchemaMap[cacheKey];
   }
@@ -9789,24 +9793,45 @@ function convertContent2(pkg, warnings, options, isSlashCommand = false) {
   const metadata = pkg.content.sections.find((s) => s.type === "metadata");
   const tools = pkg.content.sections.find((s) => s.type === "tools");
   const persona = pkg.content.sections.find((s) => s.type === "persona");
+  lines.push("---");
   if (!isSlashCommand) {
-    lines.push("---");
-    lines.push(`name: ${pkg.name}`);
+    lines.push(`name: ${pkg.id}`);
     if ((metadata == null ? void 0 : metadata.type) === "metadata") {
       lines.push(`description: ${metadata.data.description}`);
     }
     const toolsValue = ((_a = options == null ? void 0 : options.claudeConfig) == null ? void 0 : _a.tools) || ((tools == null ? void 0 : tools.type) === "tools" ? tools.tools.join(", ") : void 0);
     if (toolsValue) {
-      lines.push(`allowed-tools: ${toolsValue}`);
+      lines.push(`tools: ${toolsValue}`);
     }
     const storedModel = (metadata == null ? void 0 : metadata.type) === "metadata" ? (_b = metadata.data.claudeAgent) == null ? void 0 : _b.model : void 0;
     const modelValue = ((_c = options == null ? void 0 : options.claudeConfig) == null ? void 0 : _c.model) || storedModel;
     if (modelValue) {
       lines.push(`model: ${modelValue}`);
     }
-    lines.push("---");
-    lines.push("");
+  } else {
+    const claudeSlashCommand = (metadata == null ? void 0 : metadata.type) === "metadata" ? metadata.data.claudeSlashCommand : void 0;
+    if (claudeSlashCommand) {
+      if (claudeSlashCommand.allowedTools) {
+        lines.push(`allowed-tools: ${claudeSlashCommand.allowedTools}`);
+      }
+      if (claudeSlashCommand.argumentHint) {
+        lines.push(`argument-hint: ${claudeSlashCommand.argumentHint}`);
+      }
+      if (claudeSlashCommand.description) {
+        lines.push(`description: ${claudeSlashCommand.description}`);
+      }
+      if (claudeSlashCommand.model) {
+        lines.push(`model: ${claudeSlashCommand.model}`);
+      }
+      if (claudeSlashCommand.disableModelInvocation !== void 0) {
+        lines.push(`disable-model-invocation: ${claudeSlashCommand.disableModelInvocation}`);
+      }
+    } else if ((metadata == null ? void 0 : metadata.type) === "metadata" && metadata.data.description) {
+      lines.push(`description: ${metadata.data.description}`);
+    }
   }
+  lines.push("---");
+  lines.push("");
   if ((metadata == null ? void 0 : metadata.type) === "metadata") {
     const { title, icon } = metadata.data;
     if (icon) {
@@ -10282,9 +10307,10 @@ function toKiro(pkg, options = {}) {
   const warnings = [];
   let qualityScore = 100;
   try {
-    const config = options.kiroConfig;
-    if (!config || !config.inclusion) {
-      throw new Error("Kiro format requires inclusion mode (always|fileMatch|manual)");
+    const config = options.kiroConfig || { inclusion: "always" };
+    if (!config.inclusion) {
+      config.inclusion = "always";
+      warnings.push('No inclusion mode specified, defaulting to "always" per schema');
     }
     if (config.inclusion === "fileMatch" && !config.fileMatchPattern) {
       throw new Error("fileMatch inclusion mode requires fileMatchPattern");
@@ -10318,7 +10344,7 @@ ${content}`;
 }
 function generateFrontmatter2(config) {
   const lines = ["---"];
-  lines.push(`inclusion: ${config.inclusion}`);
+  lines.push(`inclusion: ${config.inclusion || "always"}`);
   if (config.inclusion === "fileMatch" && config.fileMatchPattern) {
     lines.push(`fileMatchPattern: "${config.fileMatchPattern}"`);
   }
@@ -10783,16 +10809,7 @@ function toAgentsMd(pkg, options = {}) {
   let qualityScore = 100;
   try {
     const config = options.agentsMdConfig || {};
-    const content = convertContent5(pkg, warnings, config);
-    let fullContent;
-    if (config.includeFrontmatter && (config.project || config.scope)) {
-      const frontmatter = generateFrontmatter3(config);
-      fullContent = `${frontmatter}
-
-${content}`;
-    } else {
-      fullContent = content;
-    }
+    const fullContent = convertContent5(pkg, warnings, config);
     const lossyConversion = warnings.some((w) => w.includes("not supported") || w.includes("skipped"));
     if (lossyConversion) {
       qualityScore -= 10;
@@ -10815,17 +10832,6 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter3(config) {
-  const lines = ["---"];
-  if (config.project) {
-    lines.push(`project: ${config.project}`);
-  }
-  if (config.scope) {
-    lines.push(`scope: ${config.scope}`);
-  }
-  lines.push("---");
-  return lines.join("\n");
-}
 function convertContent5(pkg, warnings, config) {
   var _a, _b, _c;
   const lines = [];
@@ -13882,6 +13888,9 @@ async function validatePackageFiles(manifest) {
       if (manifest.subtype === "skill") {
         return filePath.endsWith("SKILL.md");
       }
+      if (manifest.subtype === "hook") {
+        return false;
+      }
       if (filePath.endsWith(".json")) {
         return false;
       }
@@ -14418,6 +14427,15 @@ ${"=".repeat(60)}`);
           }
           console.log(`   Size: ${sizeDisplay}`);
           console.log("");
+          let publishAsAuthor;
+          if ((userInfo == null ? void 0 : userInfo.is_admin) && manifest.author) {
+            publishAsAuthor = typeof manifest.author === "string" ? manifest.author : manifest.author.name;
+            console.log(`   \u{1F510} Admin override: Publishing as author "${publishAsAuthor}"`);
+          }
+          if (selectedOrgId) {
+            console.log(`   Publishing as organization: ${(_b = userInfo.organizations.find((org) => org.id === selectedOrgId)) == null ? void 0 : _b.name}`);
+            console.log(`   Organization ID: ${selectedOrgId}`);
+          }
           if (options.dryRun) {
             console.log("\u2705 Dry run successful! Package is ready to publish.");
             publishedPackages.push({
@@ -14429,15 +14447,6 @@ ${"=".repeat(60)}`);
             break;
           }
           console.log("\u{1F680} Publishing to registry...");
-          let publishAsAuthor;
-          if ((userInfo == null ? void 0 : userInfo.is_admin) && manifest.author) {
-            publishAsAuthor = typeof manifest.author === "string" ? manifest.author : manifest.author.name;
-            console.log(`   \u{1F510} Admin override: Publishing as author "${publishAsAuthor}"`);
-          }
-          if (selectedOrgId) {
-            console.log(`   Publishing as organization: ${(_b = userInfo.organizations.find((org) => org.id === selectedOrgId)) == null ? void 0 : _b.name}`);
-            console.log(`   Organization ID: ${selectedOrgId}`);
-          }
           const publishOptions = {};
           if (selectedOrgId) {
             publishOptions.orgId = selectedOrgId;

package/dist/schemas/agents-md.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/agents-md.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/agents-md.json",
+  "$comment": "Official documentation: https://docs.factory.ai/cli/configuration/agents-md",
   "title": "agents.md Format",
   "description": "JSON Schema for agents.md format - plain markdown project-specific AI instructions (NO frontmatter)",
   "type": "object",

package/dist/schemas/canonical.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/canonical.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/canonical.json",
   "title": "PRPM Canonical Package Format",
   "description": "Universal intermediate format for AI prompt packages that can be converted to any editor-specific format",
   "type": "object",

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

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/claude-agent.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/agent.json",
+  "$comment": "Official documentation: https://code.claude.com/docs/en/sub-agents",
   "title": "Claude Agent Format",
   "description": "JSON Schema for Claude Code Agents - long-running assistants with tool access",
   "type": "object",
@@ -14,26 +15,30 @@
           "type": "string",
           "pattern": "^[a-z0-9-]+$",
           "maxLength": 64,
-          "description": "Agent identifier (lowercase letters, numbers, hyphens only)"
+          "description": "Unique identifier using lowercase letters and hyphens"
         },
         "description": {
           "type": "string",
           "maxLength": 1024,
-          "description": "Brief overview of agent's functionality and use cases"
+          "description": "Natural language description of the subagent's purpose"
         },
-        "allowed-tools": {
+        "tools": {
           "type": "string",
-          "description": "Comma-separated list of available tools (e.g., 'Read, Write, Bash, WebSearch')"
+          "description": "Comma-separated list of specific tools. If omitted, inherits all tools from the main thread"
         },
         "model": {
           "type": "string",
           "enum": ["sonnet", "opus", "haiku", "inherit"],
-          "description": "Claude model to use for this agent"
+          "description": "Model to use for this subagent. Can be a model alias (sonnet, opus, haiku) or 'inherit' to use the main conversation's model. If omitted, defaults to the configured subagent model"
         },
-        "agentType": {
+        "permissionMode": {
           "type": "string",
-          "const": "agent",
-          "description": "Explicit marker for round-trip conversion"
+          "enum": ["default", "acceptEdits", "bypassPermissions", "plan", "ignore"],
+          "description": "Permission mode for the subagent. Controls how the subagent handles permission requests"
+        },
+        "skills": {
+          "type": "string",
+          "description": "Comma-separated list of skill names to auto-load when the subagent starts. Skills are loaded into the subagent's context automatically"
         }
       },
       "additionalProperties": false
@@ -48,7 +53,7 @@
       "frontmatter": {
         "name": "code-reviewer",
         "description": "Reviews code for best practices and potential issues",
-        "allowed-tools": "Read, Grep, Bash",
+        "tools": "Read, Grep, Bash",
         "model": "sonnet"
       },
       "content": "# 🔍 Code Reviewer\n\nYou are an expert code reviewer with deep knowledge of software engineering principles.\n\n## Instructions\n\n- Check for code smells and anti-patterns\n- Verify test coverage"

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

@@ -1,8 +1,9 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/claude-hook.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/hook.json",
+  "$comment": "Official documentation: https://code.claude.com/docs/en/hooks",
   "title": "Claude Hook Format",
-  "description": "JSON Schema for Claude Code Hooks - executable code triggered by events",
+  "description": "JSON Schema for Claude Code Hooks - executable code triggered by events. Valid hook events: PreToolUse (blocks the tool call, shows stderr to Claude), PermissionRequest (denies the permission, shows stderr to Claude), PostToolUse (shows stderr to Claude, tool already ran), Notification (shows stderr to user only), UserPromptSubmit (blocks prompt processing, erases prompt, shows stderr to user only), Stop (blocks stoppage, shows stderr to Claude), SubagentStop (blocks stoppage, shows stderr to Claude subagent), PreCompact (shows stderr to user only), SessionStart (shows stderr to user only), SessionEnd (shows stderr to user only)",
   "type": "object",
   "required": ["frontmatter", "content"],
   "properties": {
@@ -25,6 +26,7 @@
           "type": "string",
           "enum": [
             "PreToolUse",
+            "PermissionRequest",
             "PostToolUse",
             "UserPromptSubmit",
             "Notification",
@@ -34,7 +36,7 @@
             "SessionStart",
             "SessionEnd"
           ],
-          "description": "Event that triggers this hook"
+          "description": "Event that triggers this hook. PreToolUse: blocks the tool call, shows stderr to Claude. PermissionRequest: denies the permission, shows stderr to Claude. PostToolUse: shows stderr to Claude (tool already ran). Notification: shows stderr to user only. UserPromptSubmit: blocks prompt processing, erases prompt, shows stderr to user only. Stop: blocks stoppage, shows stderr to Claude. SubagentStop: blocks stoppage, shows stderr to Claude subagent. PreCompact: shows stderr to user only. SessionStart: shows stderr to user only. SessionEnd: shows stderr to user only."
         },
         "language": {
           "type": "string",

package/dist/schemas/claude-skill.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/claude-skill.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/skill.json",
+  "$comment": "Official documentation: https://code.claude.com/docs/en/skills",
   "title": "Claude Skill Format",
   "description": "JSON Schema for Claude Code Skills - reusable patterns invoked during conversation",
   "type": "object",
@@ -20,15 +21,6 @@
           "type": "string",
           "maxLength": 1024,
           "description": "Brief overview of functionality and when to use it"
-        },
-        "allowed-tools": {
-          "type": "string",
-          "description": "Comma-separated list of allowed tools (e.g., 'Read, Grep, Glob')"
-        },
-        "skillType": {
-          "type": "string",
-          "const": "skill",
-          "description": "Explicit marker for round-trip conversion"
         }
       },
       "additionalProperties": false
@@ -42,8 +34,7 @@
     {
       "frontmatter": {
         "name": "refactor-helper",
-        "description": "Assists with code refactoring while maintaining functionality",
-        "allowed-tools": "Read, Edit, Grep"
+        "description": "Assists with code refactoring while maintaining functionality"
       },
       "content": "# Refactor Helper Skill\n\nHelps refactor code while maintaining functionality.\n\n## Guidelines\n\n- Preserve existing behavior\n- Improve code structure and readability"
     }

package/dist/schemas/claude-slash-command.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/claude-slash-command.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/slash-command.json",
+  "$comment": "Official documentation: https://code.claude.com/docs/en/slash-commands",
   "title": "Claude Slash Command Format",
   "description": "JSON Schema for Claude Code Slash Commands - quick actions triggered by /command-name",
   "type": "object",
@@ -28,11 +29,6 @@
         "disable-model-invocation": {
           "type": "boolean",
           "description": "Whether to prevent SlashCommand tool from calling this command"
-        },
-        "commandType": {
-          "type": "string",
-          "const": "slash-command",
-          "description": "Explicit marker for round-trip conversion (PRPM extension)"
         }
       },
       "additionalProperties": false

package/dist/schemas/claude.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/claude.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude.json",
+  "$comment": "Official documentation: https://code.claude.com/docs/en",
   "title": "Claude Code Format",
   "description": "JSON Schema for Claude Code agents, skills, and slash commands format",
   "type": "object",

package/dist/schemas/continue.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/continue.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/continue.json",
+  "$comment": "Official documentation: https://docs.continue.dev/customize/deep-dives/rules",
   "title": "Continue Rules Format",
   "description": "JSON Schema for Continue rules format - markdown with optional YAML frontmatter or YAML configuration",
   "type": "object",

package/dist/schemas/copilot.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/copilot.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/copilot.json",
+  "$comment": "Official documentation: https://docs.github.com/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot",
   "title": "GitHub Copilot Instructions Format",
   "description": "JSON Schema for GitHub Copilot instructions (.github/copilot-instructions.md or .github/instructions/*.instructions.md)",
   "type": "object",

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

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/cursor-command.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/cursor/command.json",
+  "$comment": "Official documentation: https://cursor.com/docs/agent/chat/commands#commands",
   "title": "Cursor Command Format",
   "description": "JSON Schema for Cursor commands (slash commands) - plain Markdown files in .cursor/commands/",
   "type": "object",

package/dist/schemas/cursor.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/cursor.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/cursor.json",
+  "$comment": "Official documentation: https://cursor.com/docs/context/rules",
   "title": "Cursor Rules Format",
   "description": "JSON Schema for Cursor .cursor/rules format with MDC (Markdown Components) frontmatter",
   "type": "object",
@@ -37,21 +38,6 @@
           "items": {
             "type": "string"
           }
-        },
-        "agentType": {
-          "type": "string",
-          "enum": ["agent"],
-          "description": "Marks as agent subtype (PRPM extension for round-trip conversion)"
-        },
-        "skillType": {
-          "type": "string",
-          "enum": ["skill"],
-          "description": "Marks as skill subtype (PRPM extension for round-trip conversion)"
-        },
-        "commandType": {
-          "type": "string",
-          "enum": ["slash-command"],
-          "description": "Marks as slash command subtype (PRPM extension for round-trip conversion)"
         }
       },
       "additionalProperties": false

package/dist/schemas/droid-hook.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid/hook.json",
+  "$comment": "Official documentation: https://docs.factory.ai/cli/configuration/hooks",
+  "title": "Factory Droid Hook Format",
+  "description": "JSON Schema for Factory Droid Hooks - defined in settings.json files. Valid hook events: PreToolUse (runs before tool calls, can block them), PostToolUse (runs after tool calls complete), UserPromptSubmit (runs when user submits a prompt, before Droid processes it), Notification (runs when Droid sends notifications), Stop (runs when Droid finishes responding), SubagentStop (runs when sub-droid tasks complete), PreCompact (runs before Droid runs a compact operation), SessionStart (runs when Droid starts a new session or resumes an existing session), SessionEnd (runs when Droid session ends)",
+  "type": "object",
+  "required": ["hooks"],
+  "properties": {
+    "hooks": {
+      "type": "object",
+      "description": "Hook configurations organized by event type. Each key must be a valid hook event name.",
+      "patternProperties": {
+        "^(PreToolUse|PostToolUse|Notification|UserPromptSubmit|Stop|SubagentStop|PreCompact|SessionStart|SessionEnd)$": {
+          "type": "array",
+          "description": "Array of hook configurations for this event. PreToolUse: runs before tool calls (can block them). PostToolUse: runs after tool calls complete. UserPromptSubmit: runs when user submits a prompt, before Droid processes it. Notification: runs when Droid sends notifications. Stop: runs when Droid finishes responding. SubagentStop: runs when sub-droid tasks complete. PreCompact: runs before Droid runs a compact operation. SessionStart: runs when Droid starts a new session or resumes an existing session. SessionEnd: runs when Droid session ends.",
+          "items": {
+            "type": "object",
+            "required": ["hooks"],
+            "properties": {
+              "matcher": {
+                "type": "string",
+                "description": "Pattern for tool names. Supports exact strings, regex, or '*' for all tools. Optional for most events."
+              },
+              "hooks": {
+                "type": "array",
+                "description": "Array of commands to execute",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "required": ["type", "command"],
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": ["command"],
+                      "description": "Hook type (currently only 'command' is supported)"
+                    },
+                    "command": {
+                      "type": "string",
+                      "description": "Bash command to run. Supports $FACTORY_PROJECT_DIR variable."
+                    },
+                    "timeout": {
+                      "type": "number",
+                      "description": "Execution limit in seconds (defaults to 60)",
+                      "default": 60,
+                      "minimum": 1
+                    }
+                  }
+                }
+              },
+              "description": {
+                "type": "string",
+                "description": "Optional description for plugin hooks"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "examples": [
+    {
+      "hooks": {
+        "PreToolUse": [
+          {
+            "matcher": "write",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "prettier --write \"$FACTORY_PROJECT_DIR/src/**/*.ts\"",
+                "timeout": 30
+              }
+            ]
+          }
+        ],
+        "PostToolUse": [
+          {
+            "matcher": "*",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "git add .",
+                "timeout": 60
+              }
+            ]
+          }
+        ],
+        "SessionStart": [
+          {
+            "matcher": "startup",
+            "hooks": [
+              {
+                "type": "command",
+                "command": "echo 'Session started at $(date)' >> $FACTORY_PROJECT_DIR/.factory/session.log"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/dist/schemas/droid-skill.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid/skill.json",
+  "$comment": "Official documentation: https://docs.factory.ai/cli/configuration/skills",
+  "title": "Factory Droid Skill Format",
+  "description": "JSON Schema for Factory Droid Skills - SKILL.md files stored in .factory/skills/<skill-name>/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Unique identifier for the skill (kebab-case recommended)"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief explanation of what the skill does and when to use it"
+        },
+        "allowed-tools": {
+          "type": "array",
+          "description": "Reserved for future use. Safe to omit.",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Skill workflow and instructions as markdown"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "api-integration",
+        "description": "Integrate a new API endpoint with proper error handling"
+      },
+      "content": "# API Integration Skill\n\n## Steps\n\n1. Define the API endpoint specification\n2. Create the service layer function\n3. Add error handling and validation\n4. Write unit tests\n5. Update API documentation\n\n## Success Criteria\n\n- All tests pass\n- Error handling covers edge cases\n- Documentation is updated"
+    }
+  ]
+}

package/dist/schemas/droid-slash-command.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid/slash-command.json",
+  "$comment": "Official documentation: https://docs.factory.ai/cli/configuration/custom-slash-commands",
+  "title": "Factory Droid Slash Command Format",
+  "description": "JSON Schema for Factory Droid Slash Commands - markdown files stored in .factory/commands/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Overrides the generated summary shown in slash suggestions"
+        },
+        "argument-hint": {
+          "type": "string",
+          "description": "Appends inline usage hints (e.g., /code-review <branch-name>)"
+        },
+        "allowed-tools": {
+          "type": "array",
+          "description": "Reserved for future use. Safe to omit.",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Command instructions and workflow as markdown"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Review code for a specific branch",
+        "argument-hint": "<branch-name>"
+      },
+      "content": "# Code Review Command\n\nReview the code changes in the specified branch.\n\n## Instructions\n\n1. Compare branch with main\n2. Check for code quality issues\n3. Suggest improvements"
+    },
+    {
+      "frontmatter": {
+        "description": "Run tests for a specific file",
+        "argument-hint": "<file-path>",
+        "allowed-tools": ["bash", "read"]
+      },
+      "content": "Run tests for the specified file and report results."
+    }
+  ]
+}

package/dist/schemas/droid.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/droid.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/droid.json",
+  "$comment": "Official documentation: https://docs.factory.ai/cli/configuration",
   "title": "Factory Droid Format",
   "description": "JSON Schema for Factory Droid Skills, Hooks, and Slash Commands",
   "type": "object",

package/dist/schemas/gemini-md.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/gemini-md.json",
+  "$comment": "Official documentation: https://geminicli.com/docs/cli/gemini-md/#_top",
+  "title": "GEMINI.md Format",
+  "description": "JSON Schema for GEMINI.md format - plain markdown project-specific AI instructions (NO frontmatter)",
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain markdown content with project-specific instructions, persona definitions, coding style guides, and best practices. No frontmatter allowed. Supports @file.md syntax for importing other files."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# General Instructions\n\nYou are a helpful coding assistant.\n\n## Coding Style\n\n- Use TypeScript strict mode\n- Follow functional programming patterns\n- Write comprehensive tests"
+    },
+    {
+      "content": "# Project Context\n\nThis is a Next.js application with TypeScript.\n\n## Architecture\n\n- App Router (not Pages Router)\n- Server Components by default\n- Client Components only when needed\n\n## Database\n\nPostgreSQL with Prisma ORM"
+    }
+  ]
+}

package/dist/schemas/gemini.schema.json

@@ -1,8 +1,9 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/gemini.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/gemini.json",
+  "$comment": "Official documentation: https://geminicli.com/docs/cli/custom-commands/",
   "title": "Gemini Custom Commands Format",
-  "description": "JSON Schema for Gemini CLI custom commands (.toml format)",
+  "description": "JSON Schema for Gemini CLI custom commands - TOML files stored in .gemini/commands/",
   "type": "object",
   "required": ["prompt"],
   "properties": {

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

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/kiro-agent.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro/agent.json",
+  "$comment": "Official documentation: https://kiro.dev/docs/cli/custom-agents/",
   "title": "Kiro Agent Configuration Format",
   "description": "JSON Schema for Kiro custom agent configurations (.kiro/agents/*.json) - specialized AI assistants with specific tools and context",
   "type": "object",

package/dist/schemas/{kiro-hooks.schema.json → kiro-hook.schema.json}

@@ -1,7 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/kiro-hooks.schema.json",
-  "title": "Kiro Hooks Format",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro/hook.json",
+  "$comment": "Official documentation: https://kiro.dev/docs/hooks/",
+  "title": "Kiro Hook Format",
   "description": "JSON Schema for Kiro hook configuration files (.kiro/hooks/*.json) - event-driven automations",
   "type": "object",
   "required": ["name", "description", "version", "when", "then"],

package/dist/schemas/kiro-steering.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/kiro-steering.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/kiro-steering.json",
+  "$comment": "Official documentation: https://kiro.dev/docs/steering/",
   "title": "Kiro Steering Files Format",
   "description": "JSON Schema for Kiro steering files (.kiro/steering/*.md) - context-aware instructions with optional frontmatter (defaults to 'always' inclusion)",
   "type": "object",

package/dist/schemas/opencode-slash-command.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/opencode/slash-command.json",
+  "$comment": "Official documentation: https://opencode.ai/docs/slash-commands/",
+  "title": "OpenCode Slash Command Format",
+  "description": "JSON Schema for OpenCode Slash Commands - markdown files with YAML frontmatter stored in .opencode/command/",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["template"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Brief description of what the command does (shown in TUI)"
+        },
+        "template": {
+          "type": "string",
+          "description": "The prompt text sent to the LLM when executed. Required field. Supports placeholders: $ARGUMENTS, $1-$9, !`command`, @filename"
+        },
+        "agent": {
+          "type": "string",
+          "description": "Specifies which agent executes the command"
+        },
+        "model": {
+          "type": "string",
+          "description": "Overrides default model for this command (e.g., 'anthropic/claude-sonnet-4-20250514')"
+        },
+        "subtask": {
+          "type": "boolean",
+          "description": "Forces subagent invocation behavior when true"
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Additional command documentation or notes (optional)"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Run tests for a specific file",
+        "template": "Run the tests for $1 and report the results",
+        "agent": "test-runner",
+        "subtask": true
+      },
+      "content": "# Test Runner Command\n\nExecutes tests for the specified file and provides a detailed report."
+    },
+    {
+      "frontmatter": {
+        "template": "Review the following code for best practices:\n\n@$1",
+        "model": "anthropic/claude-sonnet-4-20250514"
+      },
+      "content": ""
+    }
+  ]
+}

package/dist/schemas/opencode.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/opencode.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/opencode.json",
+  "$comment": "Official documentation: https://opencode.ai/docs/agents/",
   "title": "OpenCode Agent Format",
   "description": "JSON Schema for OpenCode Agents - markdown files with YAML frontmatter stored in .opencode/agent/",
   "type": "object",
@@ -8,30 +9,35 @@
   "properties": {
     "frontmatter": {
       "type": "object",
-      "required": ["description"],
+      "required": ["description", "mode"],
       "properties": {
         "description": {
           "type": "string",
-          "description": "Brief description of the agent's purpose (required)"
+          "description": "Brief explanation of the agent's purpose and use cases (required)"
         },
         "mode": {
           "type": "string",
           "enum": ["subagent", "primary", "all"],
-          "description": "Determines usage context - subagent (spawned), primary (main), or all (both)"
+          "description": "Determines how the agent can be used: 'primary' (main assistant), 'subagent' (spawned by primary), or 'all' (both contexts). Required field.",
+          "default": "all"
         },
         "model": {
           "type": "string",
-          "description": "Override default LLM (e.g., 'anthropic/claude-sonnet-4-20250514')"
+          "description": "Override default model (e.g., 'anthropic/claude-sonnet-4-20250514')"
         },
         "temperature": {
           "type": "number",
           "minimum": 0.0,
           "maximum": 1.0,
-          "description": "Control response creativity (0.0-1.0 range)"
+          "description": "Controls response randomness (0.0-1.0). Defaults to model-specific values (typically 0, or 0.55 for Qwen models)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Path to custom system prompt file using {file:./path} syntax"
         },
         "tools": {
           "type": "object",
-          "description": "Enable/disable specific tool access",
+          "description": "Enable/disable specific tools. Supports wildcards (e.g., 'mymcp_*')",
           "properties": {
             "write": { "type": "boolean" },
             "edit": { "type": "boolean" },
@@ -46,7 +52,7 @@
         },
         "permission": {
           "type": "object",
-          "description": "Granular control over tool usage (ask/allow/deny)",
+          "description": "Manages tool access with values: 'ask', 'allow', or 'deny'",
           "properties": {
             "edit": {
               "type": "string",
@@ -72,10 +78,10 @@
         },
         "disable": {
           "type": "boolean",
-          "description": "Boolean to deactivate the agent"
+          "description": "When true, disables the agent"
         }
       },
-      "additionalProperties": false
+      "additionalProperties": true
     },
     "content": {
       "type": "string",

package/dist/schemas/ruler.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/ruler.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/ruler.json",
+  "$comment": "Official documentation: https://okigu.com/ruler",
   "title": "Ruler Rules Format",
   "description": "JSON Schema for Ruler .ruler/ format - plain markdown without frontmatter, used for AI coding assistant instructions",
   "type": "object",

package/dist/schemas/windsurf.schema.json

@@ -1,6 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://prpm.dev/schemas/windsurf.schema.json",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/windsurf.json",
+  "$comment": "Official documentation: https://docs.windsurf.com/windsurf/cascade/memories#rules",
   "title": "Windsurf Rules Format",
   "description": "JSON Schema for Windsurf .windsurf/rules format - plain markdown without frontmatter",
   "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "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": "^1.1.7",
-    "@pr-pm/registry-client": "^2.1.7",
-    "@pr-pm/types": "^1.1.7",
+    "@pr-pm/converters": "^1.1.8",
+    "@pr-pm/registry-client": "^2.1.8",
+    "@pr-pm/types": "^1.1.8",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",