prpm 1.2.1 → 2.1.0

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

@@ -0,0 +1,122 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude-plugin.json",
+  "$comment": "https://code.claude.com/docs/en/plugins",
+  "title": "Claude Plugin Format",
+  "description": "JSON Schema for Claude plugins - bundles of agents, skills, commands, and MCP server configurations",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Plugin identifier/slug (e.g., 'compounding-engineering')",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version (e.g., '1.0.0')",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable description of the plugin"
+    },
+    "author": {
+      "type": "string",
+      "description": "Author name and optional email (e.g., 'John Doe <john@example.com>')"
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier (e.g., 'MIT', 'Apache-2.0')"
+    },
+    "repository": {
+      "type": "string",
+      "format": "uri",
+      "description": "Repository URL"
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "Homepage URL"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Keywords for discovery"
+    },
+    "mcpServers": {
+      "type": "object",
+      "description": "MCP (Model Context Protocol) server configurations",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["stdio", "http", "sse"],
+            "description": "Server transport type"
+          },
+          "command": {
+            "type": "string",
+            "description": "Command to run for stdio servers (e.g., 'npx')"
+          },
+          "args": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Arguments for the command"
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "URL for http/sse servers"
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Environment variables for the server"
+          }
+        },
+        "oneOf": [
+          {
+            "required": ["command"],
+            "properties": {
+              "type": { "const": "stdio" }
+            }
+          },
+          {
+            "required": ["url"],
+            "properties": {
+              "type": { "enum": ["http", "sse"] }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "examples": [
+    {
+      "name": "compounding-engineering",
+      "version": "2.8.1",
+      "description": "AI-powered development tools with agents, commands, and MCP servers",
+      "author": "Kieran Klaassen <kieran@every.to>",
+      "license": "MIT",
+      "keywords": ["ai-powered", "code-review", "playwright", "browser-automation"],
+      "mcpServers": {
+        "playwright": {
+          "type": "stdio",
+          "command": "npx",
+          "args": ["-y", "@playwright/mcp@latest"]
+        },
+        "context7": {
+          "type": "http",
+          "url": "https://mcp.context7.com/mcp"
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/skill.json",
+  "$comment": "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",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$",
+          "maxLength": 64,
+          "description": "Skill identifier (lowercase letters, numbers, hyphens only)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Brief overview of functionality and when to use it"
+        },
+        "license": {
+          "type": "string",
+          "maxLength": 128,
+          "description": "Optional license identifier for the skill (e.g., MIT, Apache-2.0)"
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Comma-separated list of tools the skill is allowed to use (e.g., 'Read, Edit, Bash')"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with instructions and examples"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "refactor-helper",
+        "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

@@ -0,0 +1,77 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude/slash-command.json",
+  "$comment": "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",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "properties": {
+        "allowed-tools": {
+          "type": "string",
+          "description": "List of tools the command can use (inherits from conversation if not specified)"
+        },
+        "argument-hint": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "The arguments expected for the slash command as a string (e.g., 'add [tagId] | remove [tagId] | list')"
+            },
+            {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "The arguments expected for the slash command as an array of positional arguments (e.g., ['pr-number', 'priority', 'assignee'])"
+            }
+          ],
+          "description": "The arguments expected for the slash command. Can be a string or array of positional arguments. Shown when auto-completing the command."
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief description of the command (defaults to first line from the prompt if not specified)"
+        },
+        "model": {
+          "type": "string",
+          "description": "Specific model string (inherits from conversation if not specified)"
+        },
+        "disable-model-invocation": {
+          "type": "boolean",
+          "description": "Whether to prevent SlashCommand tool from calling this command"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with instructions for executing the command. Can include H1 title with emoji icon."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Generate documentation for selected code",
+        "allowed-tools": "Read, Edit",
+        "model": "sonnet"
+      },
+      "content": "# 📝 Documentation Generator\n\nGenerate comprehensive documentation for the selected code.\n\n## Instructions\n\n- Analyze code structure and purpose\n- Generate clear, concise documentation\n- Follow JSDoc/TSDoc format for TypeScript"
+    },
+    {
+      "frontmatter": {
+        "description": "Manage tags for files",
+        "argument-hint": "add [tagId] | remove [tagId] | list",
+        "allowed-tools": "Read, Write"
+      },
+      "content": "# Tag Manager\n\nManage tags for project files.\n\n## Usage\n\n- `/tags add <tagId>` - Add a tag\n- `/tags remove <tagId>` - Remove a tag\n- `/tags list` - List all tags"
+    },
+    {
+      "frontmatter": {
+        "description": "Bulk build GitHub Actions for PRs",
+        "argument-hint": ["pr-number", "priority", "assignee"],
+        "allowed-tools": "Bash, Read"
+      },
+      "content": "# Bulk Build Actions\n\nBuild GitHub Actions for multiple PRs.\n\n## Arguments\n\n- `pr-number` - The PR number to build\n- `priority` - Build priority (high, normal, low)\n- `assignee` - Person responsible for the build"
+    }
+  ]
+}

package/dist/schemas/claude.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/claude.json",
+  "$comment": "https://code.claude.com/docs/en",
+  "title": "Claude Code Format",
+  "description": "JSON Schema for Claude Code agents, skills, and slash commands format",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "YAML frontmatter enclosed in --- markers",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Identifier/slug for the agent/skill/command (e.g., 'code-reviewer', 'refactor-helper')"
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of what this does"
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Comma-separated list of available tools (e.g., 'Read, Write, Bash, WebSearch')",
+          "pattern": "^[A-Za-z]+(,\\s*[A-Za-z]+)*$"
+        },
+        "model": {
+          "type": "string",
+          "enum": ["sonnet", "opus", "haiku", "inherit"],
+          "description": "Claude model to use for this agent"
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content following the frontmatter. Should include H1 title (can include emoji icon), persona instructions, guidelines, examples, etc."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "code-reviewer",
+        "description": "Reviews code for best practices",
+        "allowed-tools": "Read, Grep, Bash",
+        "model": "sonnet"
+      },
+      "content": "# 🔍 Code Reviewer\n\nYou are an expert code reviewer.\n\n## Instructions\n\n- Check for code smells\n- Verify test coverage"
+    }
+  ]
+}

package/dist/schemas/continue.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/continue.json",
+  "$comment": "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",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "YAML frontmatter for metadata and file matching",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name/title for the rule (required)"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of when the rule should be used (agents may read this)"
+        },
+        "globs": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single glob pattern to match files (e.g., '**/*.{ts,tsx}')"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of glob patterns to match files"
+            }
+          ]
+        },
+        "regex": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single regex pattern to match file content"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of regex patterns to match file content"
+            }
+          ]
+        },
+        "alwaysApply": {
+          "type": "boolean",
+          "description": "Inclusion behavior: true = Always included. false = Included if globs match OR agent decides. undefined/omitted = Included if no globs specified OR globs match."
+        },
+        "version": {
+          "type": "string",
+          "description": "Rule version (for YAML format)"
+        },
+        "schema": {
+          "type": "string",
+          "description": "Schema version (for YAML format)"
+        }
+      }
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content with rules and guidelines"
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "General Guidelines"
+      },
+      "content": "# General Guidelines\n\n- Write clean code\n- Add tests"
+    },
+    {
+      "frontmatter": {
+        "name": "Documentation Standards",
+        "globs": "docs/**/*.{md,mdx}",
+        "alwaysApply": false,
+        "description": "Standards for writing and maintaining documentation"
+      },
+      "content": "# Documentation Standards\n\n## Structure\n\n- Follow consistent heading hierarchy"
+    },
+    {
+      "frontmatter": {
+        "name": "React Component Standards",
+        "regex": "^import React",
+        "globs": ["**/*.tsx", "**/*.jsx"],
+        "alwaysApply": false
+      },
+      "content": "# React Component Standards\n\n## Component Structure\n\n- Use functional components with hooks"
+    }
+  ]
+}

package/dist/schemas/copilot.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/copilot.json",
+  "$comment": "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",
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "Optional YAML frontmatter for path-specific instructions (required for path-specific files)",
+      "properties": {
+        "applyTo": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Single glob pattern or comma-separated patterns (e.g., 'app/models/**/*.rb' or '**/*.ts,**/*.tsx'). Use '**', '*', or '**/*' for all files."
+            },
+            {
+              "type": "array",
+              "description": "Multiple glob patterns as array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "excludeAgent": {
+          "type": "string",
+          "enum": ["code-review", "coding-agent"],
+          "description": "Prevent file from being used by specific agent. 'code-review': only used by coding agent. 'coding-agent': only used by code review."
+        },
+        "subtype": {
+          "type": "string",
+          "enum": ["rule", "tool", "chatmode"],
+          "description": "Type of Copilot instruction (PRPM extension)"
+        }
+      }
+    },
+    "content": {
+      "type": "string",
+      "description": "Natural language markdown instructions. Whitespace between instructions is ignored. Simple, clear, and actionable."
+    }
+  },
+  "required": ["content"],
+  "examples": [
+    {
+      "content": "# API Development Guidelines\n\nFollow REST best practices.\n\n## Principles\n\n- Use semantic HTTP methods\n- Return appropriate status codes"
+    },
+    {
+      "frontmatter": {
+        "applyTo": "app/models/**/*.rb"
+      },
+      "content": "# Model Guidelines\n\nThese rules apply only to Ruby model files."
+    },
+    {
+      "frontmatter": {
+        "applyTo": "**/*.ts,**/*.tsx"
+      },
+      "content": "# TypeScript Guidelines\n\nThese rules apply to all TypeScript files using comma-separated patterns."
+    },
+    {
+      "frontmatter": {
+        "applyTo": ["src/api/**/*.ts", "src/services/**/*.ts"]
+      },
+      "content": "# API Guidelines\n\nThese rules apply to API files using array of patterns."
+    },
+    {
+      "frontmatter": {
+        "applyTo": "**",
+        "excludeAgent": "code-review"
+      },
+      "content": "# Coding Agent Only\n\nThese instructions are only used by the Copilot coding agent, not code review."
+    }
+  ]
+}

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

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/cursor/command.json",
+  "$comment": "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",
+  "required": ["content"],
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "Plain Markdown content describing what the command should do. No frontmatter supported."
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "content": "# Review Code\n\nReview the selected code for:\n- Code quality and best practices\n- Potential bugs or edge cases\n- Performance improvements\n- Security vulnerabilities\n\nProvide specific, actionable feedback."
+    },
+    {
+      "content": "# Generate Tests\n\nGenerate comprehensive unit tests for the selected code.\n\nInclude:\n- Happy path test cases\n- Edge cases and error handling\n- Mock external dependencies\n- Follow existing test patterns in the project"
+    },
+    {
+      "content": "# Explain Code\n\nProvide a clear explanation of what the selected code does.\n\nInclude:\n- High-level purpose\n- Step-by-step breakdown\n- Any non-obvious behavior\n- Dependencies and side effects"
+    }
+  ]
+}

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

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/cursor-hooks.json",
+  "title": "Cursor Hooks Configuration",
+  "description": "JSON Schema for Cursor hooks.json configuration files",
+  "type": "object",
+  "properties": {
+    "beforeShellExecution": {
+      "type": "string",
+      "description": "Path to script that runs before shell commands are executed"
+    },
+    "afterShellExecution": {
+      "type": "string",
+      "description": "Path to script that runs after shell commands are executed"
+    },
+    "beforeMCPExecution": {
+      "type": "string",
+      "description": "Path to script that runs before MCP tool calls"
+    },
+    "afterMCPExecution": {
+      "type": "string",
+      "description": "Path to script that runs after MCP tool calls"
+    },
+    "beforeReadFile": {
+      "type": "string",
+      "description": "Path to script that runs before files are read"
+    },
+    "afterFileEdit": {
+      "type": "string",
+      "description": "Path to script that runs after files are edited"
+    },
+    "beforeSubmitPrompt": {
+      "type": "string",
+      "description": "Path to script that runs before prompts are submitted"
+    },
+    "stop": {
+      "type": "string",
+      "description": "Path to script that runs when agent loop stops"
+    },
+    "afterAgentResponse": {
+      "type": "string",
+      "description": "Path to script that runs after agent responses"
+    },
+    "afterAgentThought": {
+      "type": "string",
+      "description": "Path to script that runs after agent thoughts"
+    },
+    "beforeTabFileRead": {
+      "type": "string",
+      "description": "Path to script that runs before tab file reads"
+    },
+    "afterTabFileEdit": {
+      "type": "string",
+      "description": "Path to script that runs after tab file edits"
+    }
+  },
+  "additionalProperties": false,
+  "minProperties": 1
+}

package/dist/schemas/cursor.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/cursor.json",
+  "$comment": "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",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "description": "YAML frontmatter enclosed in --- markers",
+      "required": ["description"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of what this rule does (REQUIRED by Cursor). Used by AI to determine relevance for 'Apply Intelligently' type."
+        },
+        "globs": {
+          "type": "array",
+          "description": "File patterns to apply this rule to. When specified, creates 'Apply to Specific Files' rule type.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "alwaysApply": {
+          "type": "boolean",
+          "description": "Whether to apply this rule to all files. true = 'Always Apply' type, false (default) = 'Apply Intelligently' or file-specific based on globs.",
+          "default": false
+        },
+        "name": {
+          "type": "string",
+          "description": "Package identifier (PRPM extension, ignored by Cursor)"
+        },
+        "tags": {
+          "type": "array",
+          "description": "Categorization tags (PRPM extension, ignored by Cursor)",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string",
+      "description": "Markdown content following the frontmatter. Standard markdown with headings, lists, code blocks, etc."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "description": "Core coding standards that apply to all files",
+        "alwaysApply": true
+      },
+      "content": "# Core Coding Standards\n\nThese standards apply to every chat session.\n\n- Write self-documenting code\n- Keep functions under 50 lines"
+    },
+    {
+      "frontmatter": {
+        "description": "RPC Service boilerplate patterns and conventions",
+        "alwaysApply": false
+      },
+      "content": "# RPC Service Patterns\n\nAgent will include this when it detects RPC service context.\n\n- Use internal RPC pattern\n- Use snake_case for service names"
+    },
+    {
+      "frontmatter": {
+        "description": "React component development standards",
+        "globs": ["src/**/*.tsx", "src/**/*.jsx"],
+        "alwaysApply": false
+      },
+      "content": "# React Component Standards\n\nApplied only to React component files.\n\n- Use functional components with hooks"
+    }
+  ]
+}