# numencore-toolkit

Personal Claude Code plugin marketplace. Self-hosted on Forgejo.

## Install

```bash
git clone ssh://git@git.numencore.com:2222/phatch/numencore-toolkit.git
claude plugin marketplace add ~/numencore-toolkit
claude plugin install numencore-core@numencore-toolkit
claude plugin install git-tools@numencore-toolkit
```

Verify with `claude plugin list` or `/reload-plugins` in an active session.

## Plugin management

```bash
# List installed
claude plugin list

# Update marketplace (re-reads from disk)
claude plugin marketplace update numencore-toolkit

# Reinstall after editing skills (re-caches)
claude plugin install <plugin>@numencore-toolkit

# Disable/enable
claude plugin disable <plugin>@numencore-toolkit
claude plugin enable <plugin>@numencore-toolkit

# Uninstall
claude plugin uninstall <plugin>@numencore-toolkit
```

## Development

After editing skills in the source directory, reinstall the plugin to update the cache:

```bash
claude plugin install <plugin>@numencore-toolkit
```

In an active session, run `/reload-plugins` to pick up changes.

For faster iteration, bypass the cache entirely:

```bash
claude --plugin-dir ~/numencore-toolkit/plugins/<plugin-name>
```

### Structure

```
plugins/<plugin-name>/
├── .claude-plugin/plugin.json
└── skills/<skill-name>/SKILL.md
```

### Adding a new plugin

1. Create `plugins/<name>/.claude-plugin/plugin.json`
2. Add skills under `plugins/<name>/skills/<skill-name>/SKILL.md`
3. Register in `.claude-plugin/marketplace.json`
4. Run `claude plugin marketplace update numencore-toolkit`
5. Run `claude plugin install <name>@numencore-toolkit`

## Plugins

| Plugin | Description |
|--------|-------------|
| `numencore-core` | Core toolkit — skill authoring, project scaffolding |
| `git-tools` | Git workflow — commit formatting, branch management |