docs: professionelle README mit Wiki-Verweisen

This commit is contained in:
2026-06-02 15:04:36 +02:00
parent 45a4f30939
commit 37612ff6b6
+24 -75
View File
@@ -1,78 +1,27 @@
# claude-marketplace (Inhalt) — knowledge-curator Plugin # Claude Marketplace
Persönlicher [Claude Code](https://docs.claude.com/en/docs/claude-code)-Marketplace — eigene Skills, Plugins und Agents direkt per `/plugin` installieren.
**Der Inhalt dieses Ordners ist die Wurzel deines Marketplace-Repos** Alle Commits sind SSH-signiert und in Gitea als **Verified** ausgewiesen.
`l.kirchner/claude-marketplace` (bereits angelegt auf ## Installation
https://gitea.luki-net.org/l.kirchner/claude-marketplace). Künftige Skills, In Claude Code:
Plugins und Agents kommen als weitere Unterordner + Einträge in
`.claude-plugin/marketplace.json` dazu.
## Layout
``` ```
.claude-plugin/marketplace.json # Marketplace-Manifest (Plugin-Liste) /plugin marketplace add https://gitea.luki-net.org/l.kirchner/claude-marketplace.git
knowledge-curator/ # Plugin #1
├── .claude-plugin/plugin.json
├── skills/knowledge-curator/SKILL.md
├── agents/{kg-graph-auditor,kg-entity-deduplicator,kg-relation-miner,kg-taxonomy-architect}.md
├── commands/{kg-curate,kg-apply}.md
├── hooks/{hooks.json,backup-memory.sh} # Auto-Backup bei Memory-Writes
└── README.md # Architektur & Sicherheit
push-to-gitea.sh # diesen Baum signiert ins Repo pushen
install.sh # local | marketplace (für andere Repos)
marketplace-entry.json # Snippet für einen FREMDEN Marketplace
```
## Veröffentlichen (Repo ist schon da, leer)
Aus diesem Ordner heraus:
```
./push-to-gitea.sh
```
Initialisiert git, setzt das Remote (SSH, Port 2222), committet (mit deiner
lokalen Signing-Config) und pusht nach `main`. Danach in Claude Code:
```
/plugin marketplace add https://gitea.luki-net.org/l.kirchner/claude-marketplace
/plugin install knowledge-curator@luki-net /plugin install knowledge-curator@luki-net
/plugin install venture@luki-net
``` ```
Danach Claude Code neu starten oder `/reload-plugins`, damit Agents, Commands und Hooks geladen werden. Der Marketplace heißt intern `luki-net` — daher das `@luki-net` im Install-Befehl.
Manuell geht's genauso: ## Plugins
| Plugin | Zweck | Doku |
``` |---|---|---|
git init -b main | **knowledge-curator** | Auditiert und restrukturiert einen MCP-Memory-Hub (Knowledge Graph): Struktur-Integrität, Dubletten, fehlende Verknüpfungen, Taxonomie — über vier read-only Subagents. Read-only per Default; Mutationen explizit, bestätigt und gesichert. | [Wiki](https://gitea.luki-net.org/l.kirchner/claude-marketplace/wiki/knowledge-curator) |
git remote add origin ssh://git@gitea.luki-net.org:2222/l.kirchner/claude-marketplace.git | **venture** | Startup-Toolkit: Pitch-Deck-Builder, Investor-Materialien, Marktrecherche, SaaS-Finanzprognosen und Executive-Summary-Writer. | [Wiki](https://gitea.luki-net.org/l.kirchner/claude-marketplace/wiki/venture) |
git add -A && git commit -S -m "feat: knowledge-curator plugin" && git push -u origin main ## Voraussetzungen
``` - Claude Code mit Plugin-Unterstützung.
- `knowledge-curator` benötigt zusätzlich einen verbundenen MCP-Memory-Server (Knowledge-Graph-Typ). Der Backup-Hook erwartet `KG_MEMORY_FILE` auf dessen Datendatei — siehe Wiki.
## Weitere Plugins später hinzufügen ## Dokumentation
Ausführliche Doku im **[Wiki](https://gitea.luki-net.org/l.kirchner/claude-marketplace/wiki)**:
1. Neuen Unterordner anlegen (`<plugin>/` mit `.claude-plugin/plugin.json` + - **Installation** — Voraussetzungen, MCP-Memory-Server, Env-Variablen
`skills/`/`agents/`/`commands/`/`hooks/`). - **knowledge-curator** — Architektur, Commands, Hooks, Sicherheitsmodell
2. Eintrag ins `plugins`-Array von `.claude-plugin/marketplace.json` - **venture** — Skills & Nutzung
(`{"name": "...", "source": "./<plugin>", "description": "..."}`). - **Entwicklung** — Plugin anlegen und signiert veröffentlichen
3. Committen, pushen. In Claude Code: `/plugin marketplace update luki-net`, ## Lizenz
dann `/plugin install <plugin>@luki-net`. MIT
## Schneller Test ohne Marketplace
`./install.sh local` kopiert Skill/Agents/Commands/Hooks direkt nach
`~/.claude/`. Danach Claude Code neu starten bzw. `/reload-plugins`.
## Wichtig nach der Installation
- Skill-Änderungen greifen sofort; Änderungen an `agents/`, `commands/`,
`hooks/` brauchen `/reload-plugins` oder Neustart.
- **Hook konfigurieren:** Der Backup-Hook braucht den Pfad zur Memory-Graph-
Datei. `KG_MEMORY_FILE` (oder `MEMORY_FILE_PATH`) in deiner Claude-Code-Env
setzen — sonst überspringt der Hook das Datei-Backup sauber (blockiert nie).
Optional: `KG_BACKUP_DIR` (Default `~/.claude/kg-backups`),
`KG_BACKUP_DEBOUNCE` (120s), `KG_BACKUP_KEEP` (20).
- **MCP-Tool-Namen prüfen:** Agents whitelisten `mcp__memory__read_graph`,
`…__search_nodes`, `…__open_nodes`; der Hook matcht
`mcp__memory__(create|add|delete)_*`. Heißt dein Server anders, in
`knowledge-curator/agents/*.md`, `hooks/hooks.json` und SKILL.md anpassen.
Check: `claude mcp list` bzw. `/mcp`.
Architektur, Sicherheit, Kosten: siehe `knowledge-curator/README.md`.