example-calculator

Awesome Claude Plugins

A curated marketplace of awesome plugins for Claude, following the Claude Plugin Marketplace specification.

About

This repository serves as a plugin marketplace for Claude, providing a centralized location to discover and share Claude plugins. Plugins extend Claude's capabilities and enable integration with various tools and services.

Note: The plugin examples and structure in this repository are based on the official Claude Code plugin examples.

🚀 Quick Start

Add Marketplace from GitHub

Add this marketplace to Claude Code:

/plugin marketplace add GiladShoham/awesome-claude-plugins

Test Marketplace Locally

Before publishing, you can test the marketplace locally:

/plugin marketplace add /path/to/awesome-claude-plugins

Browse and Install Plugins

Then browse and install individual plugins:

/plugin

Install a specific plugin:

/plugin install example-calculator@awesome-claude-plugins

List installed marketplaces:

/plugin marketplace list

Marketplace Structure

This marketplace follows the Claude plugin marketplace format:

• marketplace.json - Marketplace metadata and configuration
• plugins/ - Directory containing individual plugin directories
• Each plugin is a directory containing:
  • .claude-plugin/ - Plugin configuration directory
    • plugin.json - Plugin metadata (JSON)
  • hooks/ - Lifecycle hooks
  • agents/ - Agent definitions
  • commands/ - Custom commands

Available Plugins

Browse the plugins/ directory to discover available plugins. Each plugin includes:

• Name: Unique identifier for the plugin
• Version: Semantic versioning
• Description: What the plugin does
• Author: Plugin maintainer information

Example Plugins

• Calculator Plugin (example-calculator) v1.0.0 - A simple calculator plugin for performing basic arithmetic operations
• Weather Plugin (example-weather) v1.2.0 - Get current weather information and forecasts for any location
• Translator Plugin (example-translator) v2.0.0 - Translate text between multiple languages with high accuracy

Adding Your Plugin

To add your plugin to this marketplace:

1. Fork this repository

2. Create a new directory in plugins/ with your plugin name: plugins/your-plugin-name/

3. Create the required structure:

   plugins/your-plugin-name/
   ├── .claude-plugin/         # Plugin configuration directory
   │   └── plugin.json         # Plugin metadata
   ├── hooks/                  # Lifecycle hooks
   ├── agents/                 # Agent definitions
   └── commands/               # Custom commands
   

4. Fill in your .claude-plugin/plugin.json file with plugin details:

{
  "name": "your-plugin-name",
  "version": "1.0.0",
  "description": "A brief description of what your plugin does",
  "author": {
    "name": "Your Name",
    "email": "[email protected]"
  }
}

5. Validate your plugin definition locally:

   ./validate-plugins.sh
   

6. Submit a pull request with your plugin

Plugin Guidelines

• Use semantic versioning (MAJOR.MINOR.PATCH)
• Provide clear, concise descriptions
• Ensure your plugin repository is publicly accessible
• Include proper documentation in your plugin repository

For more examples, see the official Claude Code plugins.

Usage

To use this marketplace with Claude:

1. Configure your Claude instance to point to this marketplace
2. Browse available plugins through the Claude interface
3. Install plugins directly from the marketplace
4. Enable/disable plugins as needed for your workflow

Refer to the official Claude plugin documentation for detailed setup instructions.

Validation

We provide tools to validate plugin definitions:

Local Validation

Run the validation script locally before submitting:

./validate-plugins.sh

This script checks:

• Valid JSON syntax
• Required fields presence
• Semantic versioning format
• Filename consistency with plugin name

Automated CI Validation

All pull requests are automatically validated through GitHub Actions, which checks:

• Plugin JSON validity
• Marketplace.json validity
• No duplicate plugin names
• All marketplace references are valid

Contributing

Contributions are welcome! Please read our CONTRIBUTING.md guidelines before submitting pull requests.

Contribution Process