---

name: example-visibility-test description: Tests marketplace visibility configurations and catalog tiers (preview catalog only) version: 1.0.0 author: Skills Marketplace Team category: examples tags:

• testing
• preview
• development

---

Example Visibility Test

This skill demonstrates the two-tier catalog system and is used for testing marketplace visibility configurations.

Purpose

• 🧪 Test preview catalog functionality
• 📊 Verify catalog tier system
• 🔍 Validate skill visibility

This skill intentionally appears only in the preview catalog to demonstrate the two-tier system.

Catalog Tiers

The Skills Marketplace uses a two-tier catalog system:

Stable Catalog (marketplace.json)

Purpose: Production-ready skills

• ✅ Fully tested and documented
• ✅ Stable, reliable, production-ready
• ✅ Semantic versioning guaranteed
• ✅ Suitable for general use

Preview Catalog (marketplace-preview.json)

Purpose: Beta skills and early access

• 🧪 Experimental features
• 🚀 Early access to new skills
• ⚠️ May have breaking changes
• 🧑‍💻 Perfect for testing and feedback

Skill Lifecycle

Skills typically progress through these stages:

CopyDevelopment → Preview Catalog → Testing → Stable Catalog
     ↓              ↓              ↓            ↓
   Local        Beta Users    Feedback    Production

1. Local Development - Created and tested locally
2. Preview Catalog - Submitted for community testing
3. Testing Period - Community provides feedback
4. Stable Catalog - Promoted after successful testing

This Skill's Visibility

This skill appears in:

• ✅ Preview catalog (marketplace-preview.json)

This skill does NOT appear in:

• ❌ Stable catalog (marketplace.json)

This demonstrates that skills can be in preview only, stable only, or both.

Installation

From Preview Catalog

Copy# Add marketplace with preview catalog
/plugin marketplace add token-eater/skills-marketplace?ref=.claude-plugin/marketplace-preview.json

# Install this skill
/plugin install example-visibility-test

From Stable Catalog

Copy# Add marketplace (default: stable catalog)
/plugin marketplace add token-eater/skills-marketplace

# This skill will NOT appear (it's preview-only)
/plugin list

Testing Visibility

Use this skill to test catalog configurations:

Test 1: Stable Catalog

Copy# Add stable catalog
/plugin marketplace add token-eater/skills-marketplace

# List skills
/plugin list

# Expected: example-visibility-test NOT in list

Test 2: Preview Catalog

Copy# Add preview catalog
/plugin marketplace add token-eater/skills-marketplace?ref=.claude-plugin/marketplace-preview.json

# List skills
/plugin list

# Expected: example-visibility-test IS in list

Test 3: Local Development

Copy# Add local marketplace
cd /path/to/skills-marketplace
/plugin marketplace add .

# List skills
/plugin list

# Expected: All skills visible (including this one)

Use Cases for Preview Catalog

Skills appropriate for preview catalog:

• 🧪 Experimental features - Testing new functionality
• 🚀 Early access - Get feedback before stable release
• 🔄 Active development - Rapidly changing
• 📝 Incomplete docs - Documentation in progress
• ⚠️ Breaking changes - API not finalized

Promotion to Stable

After testing in preview, skills are promoted to stable when:

1. ✅ Testing complete - Verified by community
2. ✅ Feedback addressed - Issues resolved
3. ✅ Documentation complete - Fully documented
4. ✅ Stable API - No breaking changes expected
5. ✅ Maintainer approval - Project maintainers approve

For Skill Developers

If you're testing a new skill:

1. Submit to preview catalog - Add to marketplace-preview.json
2. Request testers - Ask community for feedback
3. Iterate - Fix issues, improve documentation
4. Request promotion - Ask maintainers to move to stable

Resources

• 📖 Creating Skills Guide
• 🤝 Contributing Guide
• 📥 Installation Guide
• 🏗️ Architecture Guide

Support

• 💬 GitHub Discussions
• 🐛 Report Issues

---

For contributors: Use this skill as a reference when submitting new skills to the preview catalog.