OpenSkillIndex← back to search
claude-codeexamples

Claude-skill-registry example-visibility-test

Tests marketplace visibility configurations and catalog tiers (preview catalog only)

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/example-visibility-test" ~/.claude/skills/majiayu000-claude-skill-registry-example-visibility-test && rm -rf "$T"
manifest: skills/data/example-visibility-test/SKILL.md
source content

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:

Development → 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

# 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

# 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

# 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

# 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

# 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

Support

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