Skip to main content

​
Publishing to PRPM

Learn how to publish your AI tool configurations to the PRPM registry.

​
Prerequisites

  1. PRPM CLI installed: npm install -g prpm
  2. GitHub account: Required for authentication
  3. Valid prpm.json: Package manifest in your repository

​
Authentication

Login using GitHub: 
prpm login
Check authentication status: 
prpm whoami

​
Publishing Your First Package

​
1. Create prpm.json

Let AI help you create prpm.json! Install the prpm-json package for expert guidance:
# For Claude Code
prpm install @prpm/prpm-json-best-practices-skill

# For Cursor
prpm install @prpm/prpm-json-best-practices
The AI will then help you structure your manifest with proper fields, tags, and examples.
Create a manifest file in your project root: 
{
  "name": "my-@username/typescript-rules",
  "version": "1.0.0",
  "description": "My TypeScript coding standards and best practices",
  "author": "Your Name <you@example.com>",
  "license": "MIT",
  "repository": "https://github.com/username/repo",
  "format": "cursor",
  "subtype": "rule",
  "tags": ["typescript", "best-practices"],
  "files": [".cursor/rules/typescript.mdc"]
}

​
2. Validate

Test your manifest before publishing: 
prpm publish --dry-run
This checks:
  • ✓ prpm.json syntax is valid
  • ✓ All required fields are present
  • ✓ All files exist
  • ✓ Tags are properly formatted
  • ✓ Version follows semver

​
3. Publish

Publish your package: 
prpm publish
That’s it! Your package is now available on the PRPM registry.

​
Publishing Multiple Packages

For repositories containing multiple packages, use the packages array: 
{
  "name": "my-prompts-repo",
  "author": "Your Name",
  "license": "MIT",
  "packages": [
    {
      "name": "typescript-cursor-rules",
      "version": "1.0.0",
      "description": "TypeScript rules for Cursor",
      "format": "cursor",
      "subtype": "rule",
      "tags": ["typescript"],
      "files": [".cursor/rules/typescript.mdc"]
    },
    {
      "name": "python-claude-skill",
      "version": "1.0.0",
      "description": "Python best practices for Claude",
      "format": "claude",
      "subtype": "skill",
      "tags": ["python"],
      "files": [".claude/skills/python-expert/SKILL.md"]
    }
  ]
}
Publish all packages: 
prpm publish
Or publish only a specific package: 
prpm publish --package typescript-cursor-rules

​
Versioning

Follow Semantic Versioning:
Change TypeVersion BumpExample
Bug fix, typoPatch1.0.0 → 1.0.1
New feature (backward compatible)Minor1.0.0 → 1.1.0
Breaking changeMajor1.0.0 → 2.0.0

​
Tags

Use 3-8 relevant tags per package: Good tags: 
{
  "tags": ["typescript", "type-safety", "best-practices"]
}
Bad tags: 
{
  "tags": ["code", "stuff", "TypeScript"]  // Too generic, wrong case
}

​
Next Steps

Manifest Reference

Complete prpm.json documentation

Publishing Collections

Create package collections