diff --git a/README.md b/README.md index cb2ebdc..1749bd7 100644 --- a/README.md +++ b/README.md @@ -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 (`/` mit `.claude-plugin/plugin.json` + - `skills/`/`agents/`/`commands/`/`hooks/`). -2. Eintrag ins `plugins`-Array von `.claude-plugin/marketplace.json` - (`{"name": "...", "source": "./", "description": "..."}`). -3. Committen, pushen. In Claude Code: `/plugin marketplace update luki-net`, - dann `/plugin install @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