101 lines
3.1 KiB
Markdown
101 lines
3.1 KiB
Markdown
# 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
|
|
```
|
|
|
|
## 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
|
|
```
|