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
**Der Inhalt dieses Ordners ist die Wurzel deines Marketplace-Repos**
`l.kirchner/claude-marketplace` (bereits angelegt auf
https://gitea.luki-net.org/l.kirchner/claude-marketplace). Künftige Skills,
Plugins und Agents kommen als weitere Unterordner + Einträge in
`.claude-plugin/marketplace.json` dazu.
## Layout
# Claude Marketplace
Persönlicher [Claude Code](https://docs.claude.com/en/docs/claude-code)-Marketplace — eigene Skills, Plugins und Agents direkt per `/plugin` installieren.
Alle Commits sind SSH-signiert und in Gitea als **Verified** ausgewiesen.
## Installation
In Claude Code:
```
.claude-plugin/marketplace.json # Marketplace-Manifest (Plugin-Liste)
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 marketplace add https://gitea.luki-net.org/l.kirchner/claude-marketplace.git
/plugin install knowledge-curator@luki-net
/plugin install venture@luki-net
```
Manuell geht's genauso:
```
git init -b main
git remote add origin ssh://git@gitea.luki-net.org:2222/l.kirchner/claude-marketplace.git
git add -A && git commit -S -m "feat: knowledge-curator plugin" && git push -u origin main
```
## Weitere Plugins später hinzufügen
1. Neuen Unterordner anlegen (`<plugin>/` mit `.claude-plugin/plugin.json` +
`skills/`/`agents/`/`commands/`/`hooks/`).
2. Eintrag ins `plugins`-Array von `.claude-plugin/marketplace.json`
(`{"name": "...", "source": "./<plugin>", "description": "..."}`).
3. Committen, pushen. In Claude Code: `/plugin marketplace update luki-net`,
dann `/plugin install <plugin>@luki-net`.
## 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`.
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.
## Plugins
| Plugin | Zweck | Doku |
|---|---|---|
| **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) |
| **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) |
## 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.
## Dokumentation
Ausführliche Doku im **[Wiki](https://gitea.luki-net.org/l.kirchner/claude-marketplace/wiki)**:
- **Installation** — Voraussetzungen, MCP-Memory-Server, Env-Variablen
- **knowledge-curator** — Architektur, Commands, Hooks, Sicherheitsmodell
- **venture** — Skills & Nutzung
- **Entwicklung** — Plugin anlegen und signiert veröffentlichen
## Lizenz
MIT