PRPM JSON Best Practices

Enforce required fields and structure for PRPM package manifests.

1|1|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/NangoHQ/ai-ide-prompts --skill prpm-json-best-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: PRPM JSON Best Practices
Source: https://github.com/NangoHQ/ai-ide-prompts/tree/main/.claude/skills/prpm-json-best-practices-skill
Command: npx skills add https://github.com/NangoHQ/ai-ide-prompts --skill prpm-json-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users struggle with correctly structuring prpm.json files for publishing AI packages, leading to errors, failed deployments, and difficulty in discovery. This Skill provides clear, expert guidance to ensure prpm.json manifests are correctly formatted, complete, and optimized for the PRPM registry.

Core Features & Use Cases

  • Manifest Structure Guidance: Learn the correct JSON structure for single and multi-package repositories.
  • Required Fields & Best Practices: Understand all mandatory fields, optional enhancements, and best practices for tags, versioning, and file management.
  • Validation & Troubleshooting: Includes checklists and common mistakes to avoid, ensuring your packages are ready for publication.
  • Use Case: A developer is creating a new AI agent and needs to publish it to the PRPM registry. This Skill guides them step-by-step through creating a compliant prpm.json manifest, ensuring their agent is discoverable and installable by others.

Quick Start

Use the PRPM JSON Best Practices skill to review my prpm.json file for publishing a new Claude skill. Focus on required fields and tag best practices.

Frequently Asked Questions about PRPM JSON Best Practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What fields are required in a prpm.json manifest?

Required fields in prpm.json include name, version, description, author, license, format, subtype, and files. These enforce consistency across the PRPM registry and ensure packages are discoverable and installable. All must be present for successful publication.

How do I structure a prpm.json file for publishing an AI package?

Structure prpm.json with required fields at the top level, then organize files and metadata by package. For single packages, nest everything under one entry; for multi-package repositories, use an array structure. Include tags, repository, and organization metadata aligned with PRPM conventions.

What are common mistakes when publishing packages to PRPM?

Common mistakes include missing required fields, incorrect version formatting, incomplete file listings, and poorly chosen tags that reduce discoverability. Validation checklists catch these before deployment, preventing failed publishes and ensuring your package meets registry standards.

Can I publish multiple packages in a single repository?

Yes, PRPM supports multi-package repository structures in prpm.json. Each package gets its own manifest entry with required fields and file organization. This allows you to manage related packages cohesively while maintaining separate versioning and metadata.

How do tags and metadata improve package discovery?

Tags and organization metadata in prpm.json make your package findable by category, function, and author in the PRPM registry. Correctly formatted tags and repository references improve search ranking and help users locate your package when browsing or searching by intent.