# 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)

Dieses Repo ist öffentlich lesbar. Der Marketplace lässt sich deshalb direkt über
seine HTTPS-URL hinzufügen — ohne Zugangsdaten und ohne git-Konfiguration:

```bash
/plugin marketplace add https://gitea.inmedias.it/inmedias.it/claude-plugins.git
```

Zum **Pushen** ist weiterhin ein Gitea-SSH-Key auf Port 2222 nötig.

> Hinweis: `/plugin marketplace add` akzeptiert nur `owner/repo` (immer GitHub!),
> `https://…` oder einen lokalen `./path` — **kein** `ssh://`.
>
> Falls das Repo wieder auf privat gestellt wird, kann der Plugin-Clone nicht
> interaktiv nach Zugangsdaten fragen. Dann muss git HTTPS-Zugriffe auf das Gitea
> transparent auf SSH umleiten:
>
> ```bash
> git config --global url."ssh://gitea@gitea.inmedias.it:2222/".insteadOf "https://gitea.inmedias.it/"
> ```
>
> Diese Regel gilt für **alle** git-Operationen auf `gitea.inmedias.it`, nicht nur
> für Plugins.

## 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
```

### redmine

Redmine (redmine.inmedias.it) über die REST-API: Projekte und Tickets auflisten,
anzeigen, anlegen, aktualisieren und kommentieren — via mitgelieferter,
self-contained `redmine.py` (`me`/`projects`/`issues`/`show`/`create`/`update`/
`comment`/`meta`). Namen (Projekt/Tracker/Status/Priorität) werden auf IDs
aufgelöst.

- Voraussetzung: `REDMINE_URL` und persönlicher `REDMINE_API_KEY` als
  Umgebungsvariable bzw. dotenv-Datei (kein Key im Plugin). API-Key unter
  https://redmine.inmedias.it/my/account.

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

### grill-me

Löchert dich gnadenlos mit Fragen zu einem Plan, einer Entscheidung oder Idee —
geht den Entscheidungsbaum Zweig für Zweig durch, eine Frage nach der anderen (je
mit Empfehlung), bis ein gemeinsames Verständnis steht. Startet die Umsetzung erst
nach deiner Bestätigung.

- Kein Setup, keine Zugangsdaten. Auslösen mit „grill mich" bzw. wenn du deinen
  Plan stresstesten willst.
- Deutsche Adaption des englischen Originals von Matt Pocock:
  [mattpocock/skills · grill-me](https://github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md).

```bash
/plugin install grill-me@inmedias-claude-plugins
```

### einfaches-technisches-deutsch

Setzt einen festen Schreibstil für Antworten: nach ASD-STE100 (Simplified
Technical English), ins Deutsche übertragen. Aktiv, Sätze mit höchstens 20
Wörtern, ein Gedanke pro Satz, gleiche Wörter für gleiche Dinge. Technische
Angaben (Pfade, Befehle, Zahlen, Preise) bleiben exakt.

- Kein Setup, keine Zugangsdaten. Auslösen mit „schreib einfacher", „einfaches
  Deutsch", „STE" o. ä.; gilt dann für die weitere Sitzung.

```bash
/plugin install einfaches-technisches-deutsch@inmedias-claude-plugins
```

### klare-sprache

Schreibt oder überarbeitet Texte in klarer, verständlicher Sprache nach
ISO 24495-1:2023 (Plain Language). Anders als `einfaches-technisches-deutsch`
kein starres Regelwerk, sondern zielgruppen- und prozessorientiert: Die Leser
sollen leicht **finden**, **verstehen** und **nutzen** können. Vier Prinzipien
(relevant, auffindbar, verständlich, nutzbar) mit Checkliste; technische Angaben
bleiben exakt.

- Kein Setup, keine Zugangsdaten. Auslösen mit „klare Sprache", „verständlich
  schreiben", „ISO 24495" o. ä. Ohne bekannte Zielgruppe fragt der Skill zuerst
  nach.

```bash
/plugin install klare-sprache@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
```