docs: professionelle README mit Wiki-Verweisen
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user