532 lines
14 KiB
Markdown
532 lines
14 KiB
Markdown
# Marketplace Skill Usage Examples
|
|
|
|
> **Practical examples for using the Marketplace Management Skill**
|
|
|
|
## Table of Contents
|
|
|
|
1. [Basic Usage](#basic-usage)
|
|
2. [Advanced Scenarios](#advanced-scenarios)
|
|
3. [Enterprise Examples](#enterprise-examples)
|
|
4. [Troubleshooting Examples](#troubleshooting-examples)
|
|
5. [Integration Examples](#integration-examples)
|
|
|
|
## Basic Usage
|
|
|
|
### Example 1: Creating Your First Marketplace
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create a new marketplace called dev-tools"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Creating marketplace 'dev-tools' at ./dev-tools using standard template
|
|
Creating directory: ./dev-tools
|
|
Creating directory: ./dev-tools/.claude-plugin
|
|
Creating directory: ./dev-tools/plugins
|
|
Creating directory: ./dev-tools/skills
|
|
Creating directory: ./dev-tools/docs
|
|
Creating directory: ./dev-tools/scripts
|
|
Creating directory: ./dev-tools/examples
|
|
Generating marketplace configuration: ./dev-tools/.claude-plugin/marketplace.json
|
|
Copying template file: README.md
|
|
Copying template file: .claude-plugin/plugin.json
|
|
Copying template file: docs/GUIDE.md
|
|
Copying template file: scripts/validate.js
|
|
Copying template file: scripts/deploy.js
|
|
Initializing git repository in: ./dev-tools
|
|
Marketplace 'dev-tools' created successfully
|
|
```
|
|
|
|
### Example 2: Validating a Marketplace
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Validate the marketplace at ./dev-tools"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Validating marketplace at: ./dev-tools
|
|
Validation completed: SUCCESS
|
|
Info messages:
|
|
Required directory found: .claude-plugin
|
|
Required file found: .claude-plugin/marketplace.json
|
|
Optional directory found: plugins
|
|
Optional directory found: skills
|
|
Optional directory found: docs
|
|
Optional directory found: scripts
|
|
Optional directory found: examples
|
|
Configuration file validated successfully
|
|
```
|
|
|
|
### Example 3: Analyzing Marketplace Health
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Analyze marketplace health for ./dev-tools"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Analyzing marketplace health: ./dev-tools
|
|
Marketplace Health Analysis
|
|
Overall Score: 85/100
|
|
Structure: 100/100
|
|
Configuration: 90/100
|
|
Plugins: 70/100
|
|
Documentation: 80/100
|
|
Recommendations:
|
|
- Add more plugins or fix existing plugin issues
|
|
- Improve documentation by adding comprehensive guides and examples
|
|
Metrics:
|
|
plugin_count: 0
|
|
skill_count: 0
|
|
total_size: 15678
|
|
last_modified: 2025-11-02T17:45:30.123Z
|
|
```
|
|
|
|
## Advanced Scenarios
|
|
|
|
### Example 4: Creating Enterprise Marketplace
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create an enterprise marketplace at ./company-marketplace with enterprise template, verbose output, and auto-validation"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Creating marketplace 'company-marketplace' at ./company-marketplace using enterprise template
|
|
Creating directory: ./company-marketplace
|
|
Creating directory: ./company-marketplace/.claude-plugin
|
|
Creating directory: ./company-marketplace/plugins
|
|
Creating directory: ./company-marketplace/skills
|
|
Creating directory: ./company-marketplace/docs
|
|
Creating directory: ./company-marketplace/tests
|
|
Creating directory: ./company-marketplace/scripts
|
|
Creating directory: ./company-marketplace/examples
|
|
Generating marketplace configuration: ./company-marketplace/.claude-plugin/marketplace.json
|
|
Copying template file: README.md
|
|
Copying template file: .claude-plugin/plugin.json
|
|
Copying template file: docs/ENTERPRISE.md
|
|
Copying template file: docs/SECURITY.md
|
|
Copying template file: scripts/validate.js
|
|
Copying template file: scripts/deploy.js
|
|
Copying template file: scripts/security-scan.js
|
|
Copying template file: tests/compliance.test.js
|
|
Initializing git repository in: ./company-marketplace
|
|
Validating marketplace at: ./company-marketplace
|
|
Validation completed: SUCCESS
|
|
Marketplace 'company-marketplace' created successfully
|
|
```
|
|
|
|
### Example 5: Deployment with Version Update
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Deploy marketplace ./dev-tools with minor version update and skip validation"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Deploying marketplace from: ./dev-tools
|
|
Current version: 1.0.0
|
|
New version: 1.1.0
|
|
Updated marketplace version to: 1.1.0
|
|
Release notes generated: ./dev-tools/RELEASE_NOTES.md
|
|
Creating git tag: v1.1.0
|
|
Git tag v1.1.0 created successfully
|
|
Pushing to remote repository...
|
|
Successfully pushed to remote repository
|
|
Deployment completed successfully
|
|
Version: 1.1.0
|
|
Release notes: ./dev-tools/RELEASE_NOTES.md
|
|
Git tag created and pushed
|
|
```
|
|
|
|
### Example 6: Community Marketplace Creation
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create a community marketplace called open-source-tools with community template"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Creating marketplace 'open-source-tools' at ./open-source-tools using community template
|
|
Creating directory: ./open-source-tools
|
|
Creating directory: ./open-source-tools/.claude-plugin
|
|
Creating directory: ./open-source-tools/plugins
|
|
Creating directory: ./open-source-tools/skills
|
|
Creating directory: ./open-source-tools/docs
|
|
Creating directory: ./open-source-tools/tests
|
|
Creating directory: ./open-source-tools/scripts
|
|
Creating directory: ./open-source-tools/examples
|
|
Generating marketplace configuration: ./open-source-tools/.claude-plugin/marketplace.json
|
|
Copying template file: README.md
|
|
Copying template file: .claude-plugin/plugin.json
|
|
Copying template file: docs/CONTRIBUTING.md
|
|
Copying template file: docs/COMMUNITY.md
|
|
Copying template file: scripts/validate.js
|
|
Copying template file: scripts/deploy.js
|
|
Initializing git repository in: ./open-source-tools
|
|
Validating marketplace at: ./open-source-tools
|
|
Validation completed: SUCCESS
|
|
Marketplace 'open-source-tools' created successfully
|
|
```
|
|
|
|
## Enterprise Examples
|
|
|
|
### Example 7: Enterprise Security Validation
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Validate enterprise marketplace at ./company-marketplace with comprehensive security checks"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Validating marketplace at: ./company-marketplace
|
|
Validation completed: SUCCESS
|
|
Info messages:
|
|
Required directory found: .claude-plugin
|
|
Required file found: .claude-plugin/marketplace.json
|
|
Optional directory found: plugins
|
|
Optional directory found: skills
|
|
Optional directory found: docs
|
|
Optional directory found: tests
|
|
Optional directory found: scripts
|
|
Optional directory found: examples
|
|
Configuration file validated successfully
|
|
Security configuration validated
|
|
Compliance checks passed
|
|
```
|
|
|
|
### Example 8: Batch Plugin Addition
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Add multiple plugins to enterprise marketplace ./company-marketplace: code-quality, security-scanner, deployment-tools"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Adding plugins to marketplace: ./company-marketplace
|
|
Adding plugin: code-quality
|
|
Creating plugin directory: ./company-marketplace/plugins/code-quality
|
|
Generating plugin configuration
|
|
Validating plugin structure
|
|
Plugin validated: code-quality
|
|
|
|
Adding plugin: security-scanner
|
|
Creating plugin directory: ./company-marketplace/plugins/security-scanner
|
|
Generating plugin configuration
|
|
Validating plugin structure
|
|
Plugin validated: security-scanner
|
|
|
|
Adding plugin: deployment-tools
|
|
Creating plugin directory: ./company-marketplace/plugins/deployment-tools
|
|
Generating plugin configuration
|
|
Validating plugin structure
|
|
Plugin validated: deployment-tools
|
|
|
|
Updated marketplace configuration with 3 plugins
|
|
Validating updated marketplace
|
|
Validation completed: SUCCESS
|
|
```
|
|
|
|
## Troubleshooting Examples
|
|
|
|
### Example 9: Debug Creation Issues
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create marketplace debug-test with verbose output to troubleshoot creation issues"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Creating marketplace 'debug-test' at ./debug-test using standard template
|
|
Creating directory: ./debug-test
|
|
Creating directory: ./debug-test/.claude-plugin
|
|
Creating directory: ./debug-test/plugins
|
|
Creating directory: ./debug-test/skills
|
|
Creating directory: ./debug-test/docs
|
|
Creating directory: ./debug-test/tests
|
|
Creating directory: ./debug-test/scripts
|
|
Creating directory: ./debug-test/examples
|
|
Generating marketplace configuration: ./debug-test/.claude-plugin/marketplace.json
|
|
Copying template file: README.md
|
|
Copying template file: .claude-plugin/plugin.json
|
|
Copying template file: docs/GUIDE.md
|
|
Copying template file: scripts/validate.js
|
|
Copying template file: scripts/deploy.js
|
|
Initializing git repository in: ./debug-test
|
|
Validating marketplace at: ./debug-test
|
|
Validation completed: SUCCESS
|
|
Marketplace 'debug-test' created successfully
|
|
```
|
|
|
|
### Example 10: Force Deployment Despite Validation Errors
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Deploy marketplace ./problematic-marketplace with force option to override validation failures"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Deploying marketplace from: ./problematic-marketplace
|
|
Validating marketplace before deployment...
|
|
Validation completed: FAILED
|
|
Errors found: 2
|
|
- Required configuration field missing: description
|
|
- Invalid version format: 1.0
|
|
|
|
Marketplace validation failed: Required configuration field missing: description
|
|
Proceeding with deployment despite validation failures (force mode)
|
|
Current version: 1.0
|
|
New version: 1.0.1
|
|
Updated marketplace version to: 1.0.1
|
|
Release notes generated: ./problematic-marketplace/RELEASE_NOTES.md
|
|
Creating git tag: v1.0.1
|
|
Git tag v1.0.1 created successfully
|
|
Pushing to remote repository...
|
|
Successfully pushed to remote repository
|
|
Deployment completed successfully
|
|
Version: 1.0.1
|
|
Release notes: ./problematic-marketplace/RELEASE_NOTES.md
|
|
Git tag created and pushed
|
|
```
|
|
|
|
## Integration Examples
|
|
|
|
### Example 11: CI/CD Pipeline Integration
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create marketplace ./ci-cd-marketplace with minimal template for automated CI/CD pipeline deployment"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Creating marketplace 'ci-cd-marketplace' at ./ci-cd-marketplace using minimal template
|
|
Creating directory: ./ci-cd-marketplace
|
|
Creating directory: ./ci-cd-marketplace/.claude-plugin
|
|
Creating directory: ./ci-cd-marketplace/plugins
|
|
Creating directory: ./ci-cd-marketplace/skills
|
|
Creating directory: ./ci-cd-marketplace/docs
|
|
Creating directory: ./ci-cd-marketplace/tests
|
|
Creating directory: ./ci-cd-marketplace/scripts
|
|
Creating directory: ./ci-cd-marketplace/examples
|
|
Generating marketplace configuration: ./ci-cd-marketplace/.claude-plugin/marketplace.json
|
|
Copying template file: README.md
|
|
Copying template file: .claude-plugin/plugin.json
|
|
Copying template file: scripts/validate.js
|
|
Initializing git repository in: ./ci-cd-marketplace
|
|
Validating marketplace at: ./ci-cd-marketplace
|
|
Validation completed: SUCCESS
|
|
Marketplace 'ci-cd-marketplace' created successfully
|
|
```
|
|
|
|
### Example 12: Multi-Environment Deployment
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Deploy marketplace ./production-marketplace to production environment with major version update and comprehensive validation"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Deploying marketplace from: ./production-marketplace
|
|
Validating marketplace before deployment...
|
|
Validation completed: SUCCESS
|
|
Current version: 2.1.0
|
|
New version: 3.0.0
|
|
Updated marketplace version to: 3.0.0
|
|
Release notes generated: ./production-marketplace/RELEASE_NOTES.md
|
|
Creating git tag: v3.0.0
|
|
Git tag v3.0.0 created successfully
|
|
Pushing to remote repository...
|
|
Successfully pushed to remote repository
|
|
Deployment completed successfully
|
|
Version: 3.0.0
|
|
Release notes: ./production-marketplace/RELEASE_NOTES.md
|
|
Git tag created and pushed
|
|
```
|
|
|
|
## Complex Workflow Examples
|
|
|
|
### Example 13: Complete Marketplace Lifecycle
|
|
|
|
**Step 1: Creation**
|
|
|
|
```bash
|
|
"Create marketplace full-lifecycle-demo with enterprise template"
|
|
```
|
|
|
|
**Step 2: Adding Content**
|
|
|
|
```bash
|
|
"Add plugins code-formatter and test-runner to marketplace ./full-lifecycle-demo"
|
|
```
|
|
|
|
**Step 3: Validation**
|
|
|
|
```bash
|
|
"Validate marketplace ./full-lifecycle-demo with comprehensive checks"
|
|
```
|
|
|
|
**Step 4: Health Analysis**
|
|
|
|
```bash
|
|
"Analyze marketplace health for ./full-lifecycle-demo and generate improvement recommendations"
|
|
```
|
|
|
|
**Step 5: Deployment**
|
|
|
|
```bash
|
|
"Deploy marketplace ./full-lifecycle-demo with minor version update"
|
|
```
|
|
|
|
### Example 14: Template Customization
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create marketplace custom-template-demo with standard template and then customize validation rules to be more strict"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Creating marketplace 'custom-template-demo' at ./custom-template-demo using standard template
|
|
[... directory creation and file copying ...]
|
|
Marketplace 'custom-template-demo' created successfully
|
|
|
|
Customizing validation rules for marketplace ./custom-template-demo...
|
|
Updated validation configuration:
|
|
{
|
|
"level": "strict",
|
|
"strict": true,
|
|
"checks": ["structure", "metadata", "plugins", "security", "documentation", "performance"]
|
|
}
|
|
|
|
Validation with custom rules completed: SUCCESS
|
|
```
|
|
|
|
## Error Handling Examples
|
|
|
|
### Example 15: Invalid Marketplace Name
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create marketplace with invalid name containing special characters!@#$"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Error: Invalid marketplace name. Names should only contain letters, numbers, hyphens, and underscores.
|
|
Please use a valid name like: my-marketplace or my_marketplace
|
|
```
|
|
|
|
### Example 16: Non-Existent Marketplace Validation
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Validate marketplace at ./non-existent-marketplace with verbose output"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Validating marketplace at: ./non-existent-marketplace
|
|
Validation completed: FAILED
|
|
Errors found: 1
|
|
- Marketplace directory does not exist
|
|
```
|
|
|
|
### Example 17: Permission Issues
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Create marketplace in restricted directory /root/protected-marketplace"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Error: Permission denied when creating directory /root/protected-marketplace
|
|
Please choose a different directory or check permissions.
|
|
```
|
|
|
|
## Performance and Scaling Examples
|
|
|
|
### Example 18: Large Marketplace Analysis
|
|
|
|
**Prompt**:
|
|
|
|
```bash
|
|
"Analyze performance of large marketplace ./large-enterprise-marketplace with 50+ plugins"
|
|
```
|
|
|
|
**Expected Output**:
|
|
|
|
```
|
|
Analyzing marketplace health: ./large-enterprise-marketplace
|
|
Scanning 52 plugins...
|
|
Analyzing plugin configurations...
|
|
Validating plugin dependencies...
|
|
Checking skill compatibility...
|
|
Marketplace Health Analysis
|
|
Overall Score: 78/100
|
|
Structure: 95/100
|
|
Configuration: 85/100
|
|
Plugins: 72/100
|
|
Documentation: 60/100
|
|
Recommendations:
|
|
- Improve documentation by adding comprehensive guides and examples
|
|
- Optimize plugin loading order for better performance
|
|
- Consider grouping related plugins into categories
|
|
Metrics:
|
|
plugin_count: 52
|
|
skill_count: 15
|
|
total_size: 157890
|
|
last_modified: 2025-11-02T17:45:30.123Z
|
|
performance_score: 72
|
|
```
|
|
|
|
---
|
|
|
|
_These examples demonstrate practical usage patterns for the Marketplace Management Skill. Adapt them to your specific needs and requirements._
|