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