# Severity1 Claude Code Marketplace

A marketplace for Claude Code plugins by severity1.

## What is This?

This marketplace provides a curated collection of Claude Code plugins that extend Claude Code's functionality with custom commands, agents, hooks, and integrations.

## Installation

To add this marketplace to your Claude Code installation:

```bash
claude plugin marketplace add severity1/severity1-marketplace
```

## Migrating from claude-code-marketplace

If you previously installed this marketplace under the old name:

### Step 1: Uninstall plugins from the old marketplace

```bash
# List plugins installed from the old marketplace
claude plugin list

# Uninstall each plugin (example)
claude plugin uninstall prompt-improver
claude plugin uninstall auto-memory
```

### Step 2: Remove the old marketplace and add the new one

```bash
# Remove the old marketplace
claude plugin marketplace remove severity1/claude-code-marketplace

# Add the new marketplace
claude plugin marketplace add severity1/severity1-marketplace
```

### Step 3: Reinstall your plugins

```bash
# Install plugins from the new marketplace
claude plugin install prompt-improver
claude plugin install auto-memory
```

## Available Plugins

### claude-code-prompt-improver
Enriches vague prompts with research-based clarifying questions before Claude Code executes them.

- **Repository**: [severity1/claude-code-prompt-improver](https://github.com/severity1/claude-code-prompt-improver)

## Contributing Plugins

To add a plugin to this marketplace:

### 1. Prepare Your Plugin

Ensure your plugin is hosted on GitHub with a valid plugin structure. Your plugin should include:

- A `.claude-plugin/plugin.json` manifest file (if using strict mode)
- Plugin components (commands, agents, hooks, or MCP servers)
- A README.md with usage instructions

### 2. Add Plugin Entry

Edit `.claude-plugin/marketplace.json` and add your plugin to the `plugins` array:

```json
{
  "name": "prompt-improver",
  "source": {
    "source": "url",
    "url": "https://github.com/severity1/claude-code-prompt-improver.git"
  },
  "description": "Type vibes, ship precision. Enriches vague/vibe-y prompts with research-based clarifying questions before Claude Code executes them."
}
```

### Required Fields
- `name`: Plugin identifier (kebab-case, no spaces)
- `source`: Git repository location
- `description`: Clear, concise plugin description

### Optional Fields

For additional fields like `version`, `author`, `homepage`, `license`, `keywords`, and `category`, see the [Plugin Marketplaces Guide](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces.md).

### 3. Submit a Pull Request

1. Fork this repository
2. Add your plugin entry to `.claude-plugin/marketplace.json`
3. Update this README.md to include your plugin in the Available Plugins section
4. Submit a pull request with:
   - Clear title: "Add [plugin-name] plugin"
   - Description of what your plugin does
   - Link to your plugin repository

### 4. Review Process

Plugin submissions will be reviewed for:
- Valid plugin structure and manifest
- Working functionality
- Clear documentation
- No malicious code
- Adherence to Claude Code plugin standards

## Source Types

Plugins can be sourced from:

**Git URL:**
```json
"source": {
  "source": "url",
  "url": "https://github.com/owner/repo-name.git"
}
```

Note: URL source uses HTTPS and does not require SSH key configuration.

**GitHub:**
```json
"source": {
  "source": "github",
  "repo": "owner/repo-name"
}
```

Note: GitHub source requires SSH key access to be configured on your system.

**Relative path (for local development):**
```json
"source": "./plugins/local-plugin"
```

## Resources

- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code)
- [Plugin Marketplaces Guide](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces.md)
- [Creating Plugins](https://docs.claude.com/en/docs/claude-code/plugins)

## License

This marketplace configuration is available under the MIT License.

## Contact

For questions or issues, contact:
- Email: johnreilly.pospos@gmail.com
- GitHub: [@severity1](https://github.com/severity1)