plugin-development

Hyperskill Claude Code Plugin Marketplace

A curated collection of Claude Code plugins maintained by the Hyperskill team.

Quick Start

Install This Marketplace

1. Add the marketplace to Claude Code:

   /plugin marketplace add hyperskill/claude-code-marketplace
   

2. Install a plugin:

   /plugin install plugin-development@hyperskill-marketplace
   

3. Or clone locally for development:

   git clone https://github.com/hyperskill/claude-code-marketplace.git
   cd claude-code-marketplace
   
   # Add your local marketplace
   /plugin marketplace add ./
   
   # Install the plugin-development plugin
   /plugin install plugin-development@hyperskill-marketplace
   

For more details, see the Testing section below.

What's Included

This marketplace provides:

• Marketplace Configuration (.claude-plugin/marketplace.json): Central registry for all plugins following the official schema
• Plugin Development Plugin (plugin-development): Comprehensive toolkit for creating, validating, and managing plugins with:
  • Scaffolding and component generation commands
  • Automated validation and testing
  • Best practices and documentation integration
  • Review agent for release readiness
• Comprehensive Documentation (docs/): Complete guides for plugin development, hooks, settings, commands, skills, and sub-agents
• GitHub Actions: Automated plugin validation workflow

Configuration

Marketplace Configuration

Edit .claude-plugin/marketplace.json to customize your marketplace:

{
  "name": "hyperskill-marketplace",
  "owner": {
    "name": "Hyperskill Inc.",
    "email": "dev@hyperskill.org"
  },
  "metadata": {
    "description": "A curated collection of Claude Code plugins by Hyperskill team",
    "version": "1.0.0"
  },
  "plugins": [
    // Add your plugins here
  ]
}

Note: The name field should use kebab-case (lowercase with hyphens). See the Plugin Marketplaces documentation for complete schema details.

Team Settings (Optional)

You can configure automatic marketplace installation for team projects by adding .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "hyperskill": {
      "source": {
        "source": "github",
        "repo": "hyperskill/claude-code-marketplace"
      }
    }
  }
}

When team members trust the repository folder, Claude Code automatically installs these marketplaces. See Configure team marketplaces for details.

Testing

Local Testing

1. Navigate to your project directory:

   cd claude-code-marketplace
   

2. Start Claude Code:

   claude
   

3. Add your local marketplace:

   /plugin marketplace add ./path-to-your-marketplace
   

4. Install a plugin:

   /plugin install plugin-development@hyperskill-marketplace
   

5. Test commands:

   /plugin-development:validate
   

6. Verify installation:

   /help
   

   Your plugin commands should appear in the help list.

Using the Marketplace from GitHub

Once published to GitHub, users can add your marketplace:

# Add marketplace from GitHub
/plugin marketplace add hyperskill/claude-code-marketplace

# Install plugins
/plugin install plugin-name@hyperskill-marketplace

Creating New Plugins

Option 1: Use the Plugin Development Plugin (Recommended)

This template includes a powerful plugin-development plugin that automates plugin scaffolding:

# After cloning and adding this marketplace
/plugin install plugin-development@hyperskill-marketplace

# Scaffold a new plugin
/plugin-development:init my-new-plugin

# Add components as needed
/plugin-development:add-command my-command "Description of what the command does"
/plugin-development:add-skill my-skill "Use when working with..."
/plugin-development:validate

See the plugin-development README for complete documentation.

Option 2: Manual Setup

# Create plugin directory
mkdir -p plugins/my-plugin/.claude-plugin
mkdir -p plugins/my-plugin/commands

# Create plugin metadata
touch plugins/my-plugin/.claude-plugin/plugin.json
touch plugins/my-plugin/README.md

Step 2: Define Plugin Metadata

Edit plugins/my-plugin/.claude-plugin/plugin.json: