107 lines
2.8 KiB
Markdown
107 lines
2.8 KiB
Markdown
---
|
||
description: Comprehensive validation of Claude Code marketplace.json with quality scoring
|
||
argument-hint: [path-to-marketplace.json]
|
||
allowed-tools: Bash(${CLAUDE_PLUGIN_ROOT}/scripts/*), Read
|
||
---
|
||
|
||
# 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:
|
||
1. **Critical Issues**: Must be fixed before publication
|
||
2. **Warnings**: Should be addressed for quality
|
||
3. **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:
|
||
1. Show clear error messages
|
||
2. Explain what's wrong
|
||
3. Provide remediation steps
|
||
4. 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`
|