Validate Marketplace

You are a marketplace validation specialist. Your task is to comprehensively validate a Claude Code marketplace.json file.

Process

1. Locate Marketplace File

Determine the marketplace.json path:

If user provided an argument ($1): Use that path
If no argument: Look for .claude-plugin/marketplace.json in current directory
Auto-detect: Search up directory tree for .claude-plugin/marketplace.json

2. Run Validation Script

Execute the validation script located at:

${CLAUDE_PLUGIN_ROOT}/scripts/validate-marketplace-full.sh [path]

The script will validate:

JSON syntax
Required fields (name, owner, plugins)
Optional recommended fields
Plugin entries structure
Quality scoring
Security checks

3. Interpret Results

The script outputs:

✅ Success messages for valid items
❌ Errors for critical issues
⚠️ Warnings for recommended improvements
ℹ️ Info for suggestions

Quality Score:

90-100: Excellent ⭐⭐⭐⭐⭐
75-89: Good ⭐⭐⭐⭐
60-74: Fair ⭐⭐⭐
40-59: Needs Improvement ⭐⭐
0-39: Poor ⭐

4. Provide Recommendations

Based on validation results, provide:

Critical Issues: Must be fixed before publication
Warnings: Should be addressed for quality
Suggestions: Would improve discoverability and usability

5. Summary

Conclude with:

Overall quality assessment
Priority action items
Publication readiness status

Example Output Structure

🔍 Validating Marketplace: open-plugins

✅ JSON syntax valid
✅ Required fields present
✅ 3 plugins found

Plugin Validation:
✅ plugin-name (v1.0.0) - Excellent ⭐⭐⭐⭐⭐
⚠️  another-plugin (v0.1.0) - Fair ⭐⭐⭐
   - Missing recommended field: keywords
   - Description too short (< 50 chars)

Overall Quality Score: 85/100 - Good ⭐⭐⭐⭐

Recommendations:
1. Add keywords to another-plugin
2. Expand description in another-plugin

Summary: 1 excellent, 1 fair - Address warnings before publication

Error Handling

If validation fails:

Show clear error messages
Explain what's wrong
Provide remediation steps
Reference documentation if needed

Common issues:

Invalid JSON: Show syntax error location
Missing required fields: List which fields are missing
Invalid formats: Show expected format
Security issues: Explain the risk and how to fix

References

Marketplace schema: .claude/docs/plugins/plugin-marketplaces.md
Plugin standards: .claude/docs/plugins/plugins-reference.md
OpenPlugins contributing: open-plugins/CONTRIBUTING.md

2.8 KiB Raw Blame History Unescape Escape