# Claude Code User Configuration

User-level Claude Code settings and skills.

## Clone with Submodules

```bash
git clone --recurse-submodules https://git.prettyhefty.com/Bill/claude-code-user-config.git ~/.claude
```

## Initialize Submodules After Clone

If you cloned without `--recurse-submodules`:

```bash
cd ~/.claude
git submodule update --init --recursive
```

## Update Submodules

Pull latest changes for all skills:

```bash
git submodule update --remote --merge
```

## Contents

| Path | Description |
|------|-------------|
| `CLAUDE.md` | Global instructions for all projects |
| `settings.json` | User permissions and plugin config |
| `plugins/config.json` | Portable plugin manifest (marketplaces + desired plugins) |
| `skills/` | User-level skills (as submodules) |

## Install Plugins on New Host

After cloning, install the desired plugins listed in `plugins/config.json`:

```bash
# Install plugins from known marketplaces
claude plugins install example-skills@anthropic-agent-skills

# For plugins with unknown marketplace sources, search and install manually:
claude plugins search superpowers
claude plugins search frontend-design
```

The `plugins/installed_plugins.json` file is auto-generated with host-specific paths and should not be committed. The portable configuration is stored in `plugins/config.json`.