devops-assistant

Swarm Claude Plugin Repository

This repository demonstrates best practices for structuring and distributing Claude plugins. It includes a complete sample plugin (devops-assistant) located in the sample-plugin subdirectory.

📁 Repository Structure

swarm-claude-plugin/                # Repository root
├── .claude-plugin/
│   └── marketplace.json            # Marketplace manifest for discovery
├── .claude-repository.json         # Repository manifest for plugin discovery  
├── sample-plugin/                  # Plugin in subdirectory (recommended structure)
│   ├── .claude-plugin/
│   │   └── plugin.json             # Plugin manifest
│   ├── commands/                   # Plugin commands
│   ├── agents/                     # AI agents
│   ├── skills/                     # Reusable skills
│   ├── hooks/                      # Lifecycle hooks
│   ├── scripts/                    # Utility scripts
│   ├── README.md                   # Plugin documentation
│   ├── QUICK_START.md              # Quick start guide
│   ├── install.sh                  # Installation script
│   └── ...
├── scripts/
│   └── list-plugins.sh             # Helper script to list installed plugins
├── install.sh                      # Main installation script
├── USER_GUIDE.md                   # Comprehensive user guide for using the plugin
├── QUICK_REFERENCE.md              # Quick reference card / cheat sheet
├── REMOTE_INSTALLATION_GUIDE.md    # Guide for remote installation
├── GIT_DISCOVERY_GUIDE.md          # Guide for Git-based discovery
├── examples/                       # Usage examples (future)
├── docs/                           # Additional documentation (future)
└── README.md                       # This file

🚀 Quick Installation

Method 1: One-Line Installation (Recommended)

# Install directly using our installation script
curl -sSL https://raw.githubusercontent.com/trilogy-group/swarm-claude-plugin/main/install.sh | bash

Method 2: GitHub Marketplace Format

# Add the repository as a marketplace (for public repos)
claude plugin marketplace add trilogy-group/swarm-claude-plugin

# Install the plugin
claude plugin install devops-assistant

Method 3: Clone and Install Locally

# Clone the repository
git clone https://github.com/trilogy-group/swarm-claude-plugin.git
cd swarm-claude-plugin

# Add as local marketplace
claude plugin marketplace add .

# Install the plugin
claude plugin install devops-assistant

Method 4: Private Repository Installation

# For private repositories, use SSH
git clone [email protected]:trilogy-group/swarm-claude-plugin.git
cd swarm-claude-plugin

# Add as local marketplace
claude plugin marketplace add .

# Install the plugin
claude plugin install devops-assistant

⚠️ Important Notes:

• The plugin requires .claude-plugin/marketplace.json for marketplace discovery
• Repository must be public for direct GitHub installation
• For private repos, clone locally first or use SSH authentication

🎯 Quick Usage

Once installed, you can use the plugin in multiple ways:

In Claude CLI Interactive Mode

# Start Claude CLI
claude

# Use plugin commands
> @devops status
> @devops logs --service api-gateway

# Natural language requests
> Check the health of our infrastructure
> Review this code for security issues

Via Command Line

# Direct execution
claude -p "@devops status --format json"

# Natural language
claude -p "Analyze our deployment logs for errors"

In Your Code (SDK)

from claude import Claude, plugins

claude = Claude()
devops = plugins.load('devops-assistant')

# Execute commands
status = devops.command('status', {'environment': 'prod'})

# Use agents
security_review = devops.agent('security-reviewer').analyze('./src')

📚 Full Documentation: See USER_GUIDE.md for comprehensive usage instructions

Manage Plugins

# Install a plugin
claude plugin install devops-assistant

# Install from specific marketplace
claude plugin install devops-assistant@swarm-claude-plugin

# Enable a plugin (use full name with marketplace)
claude plugin enable devops-assistant@swarm-claude-plugin

# Disable a plugin (use full name with marketplace)
claude plugin disable devops-assistant@swarm-claude-plugin

# Uninstall a plugin
claude plugin uninstall devops-assistant

# Validate a plugin (checks manifest structure)
claude plugin validate /path/to/plugin

Note: The plugin name format for enable/disable commands may require the full plugin@marketplace format.

Manage Marketplaces

# Add a marketplace
claude plugin marketplace add trilogy-group/swarm-claude-plugin  # GitHub format
claude plugin marketplace add /path/to/local/plugin              # Local path

# List marketplaces
claude plugin marketplace list

# Remove a marketplace
claude plugin marketplace remove swarm-claude-plugin