# inmedias Claude Code Plugins

Geteilter Plugin-Marketplace für Claude Code. Jeder Skill ist ein eigenes Plugin
und kann einzeln installiert werden — niemand bekommt alles auf einmal.

## Einrichtung (einmalig)

`/plugin marketplace add` akzeptiert nur `owner/repo` (immer GitHub!), `https://…`
oder einen lokalen `./path` — **kein** `ssh://`. Da dieses Repo privat ist und der
Plugin-Clone nicht interaktiv nach Zugangsdaten fragen kann, muss git HTTPS-Zugriffe
auf das Gitea transparent auf SSH umleiten. Einmalig pro Rechner:

```bash
# 1. git so konfigurieren, dass https auf dieses Gitea über SSH (Key) läuft
git config --global url."ssh://gitea@gitea.inmedias.it:2222/".insteadOf "https://gitea.inmedias.it/"

# 2. Marketplace mit der HTTPS-URL hinzufügen (klont real über SSH)
/plugin marketplace add https://gitea.inmedias.it/inmedias.it/claude-plugins.git
```

Voraussetzung: dein Gitea-SSH-Key ist auf Port 2222 eingerichtet.

> Hinweis: Die `insteadOf`-Regel gilt für **alle** git-Operationen auf
> `gitea.inmedias.it`, nicht nur für Plugins.
>
> Alternative ohne git-Config: Repo `inmedias.it/claude-plugins` intern/öffentlich
> lesbar machen — dann reicht die HTTPS-URL direkt (SSH-Key trotzdem für Push nötig).

## Plugin installieren

```bash
/plugin install gitea-tea@inmedias-claude-plugins
/reload-plugins
```

Verfügbare Plugins listet `/plugin` bzw. `marketplace.json`.

## Verfügbare Plugins

### gitea-tea

Gitea vom Terminal über die `tea`-CLI verwalten: Issues, PRs, Releases, Repos,
Labels, Milestones. Enthält geprüfte Befehlsreferenzen und Hinweise für den
nicht-interaktiven (AI-Agent-)Einsatz.

- Voraussetzung: `tea` installiert und via `tea login add` authentifiziert.
- Merke: Body-Flag ist `--description`/`-d` (nicht `--body`); `--output` nur bei
  Listen-/Objekt-Befehlen, nicht bei `tea whoami`.

```bash
/plugin install gitea-tea@inmedias-claude-plugins
```

### uv

`uv` statt `pip`/`python`/`venv`: Skripte mit `uv run script.py`, Dependencies mit
`uv add`, inline Script-Metadata für Standalone-Skripte. Enthält zusätzlich
`build.md` und `scripts.md` mit Detail-Rezepten.

```bash
/plugin install uv@inmedias-claude-plugins
```

### humanizer

Entfernt typische Merkmale KI-generierten Texts (aufgeblähte Symbolik,
Werbesprache, Em-Dash-Overkill, Dreierregel, Passiv usw.), damit Texte
natürlicher klingen. Basiert auf Wikipedias „Signs of AI writing".

- Vendored von [github.com/blader/humanizer](https://github.com/blader/humanizer)
  (Version 2.5.1, MIT-Lizenz liegt bei). Kein automatischer Upstream-Sync —
  Updates werden manuell nachgezogen.

```bash
/plugin install humanizer@inmedias-claude-plugins
```

### humhub

HumHub (humhub.inmedias.it) über die REST-API: Wiki-Seiten und Posts auflisten,
anzeigen, anlegen und aktualisieren — via mitgelieferter, self-contained
`humhub.py` (`wiki-list/get/update/create`, `post-list/create/update`).

- Voraussetzung: `HUMHUB_API_TOKEN` als Umgebungsvariable bzw. dotenv-Datei
  (kein Token im Plugin). Token nur als berechtigter Benutzer unter
  https://humhub.inmedias.it/rest/admin/index.

```bash
/plugin install humhub@inmedias-claude-plugins
```

### mediawiki

MediaWiki-Seiten/Templates lesen, rendern und schreiben — via mitgelieferter,
self-contained `wiki.py` (`fetch`/`render`/`search`/`update`). Instanzen `wiki`
(Prod, wiki.inmedias.it) und `devwiki` per `-w`.

- Voraussetzung: eigene Zugangsdaten (`MEDIAWIKI_USER`/`MEDIAWIKI_PASSWORD`,
  optional `DEVMEDIAWIKI_*`) als Umgebungsvariable bzw. dotenv-Datei (kein Secret
  im Plugin).
- Regel: Wiki-Seiten nur über `wiki.py`/MCP bearbeiten, nicht per
  Maintenance-Skript am Server vorbei.

```bash
/plugin install mediawiki@inmedias-claude-plugins
```

## Updates

```bash
/plugin marketplace update inmedias-claude-plugins
```

## Neuen Skill hinzufügen

1. Ordner `plugins/<name>/` anlegen mit:
   - `.claude-plugin/plugin.json` (`name`, `version`, `description`)
   - `skills/<name>/SKILL.md`
2. Eintrag in `.claude-plugin/marketplace.json` unter `plugins` ergänzen.
3. Committen und pushen.

## Struktur

```
.claude-plugin/marketplace.json   ← Liste aller Plugins
plugins/
  gitea-tea/
    .claude-plugin/plugin.json
    skills/gitea-tea/SKILL.md
```