# Installation Obsidian Skill für Claude Code, Opencode und Hermes

## 0. Voraussetzungen (für alle Agents)

1. **Obsidian installiert** und ein Vault vorhanden (z.B. `D:\Knowledge\Vault` oder `~/Vault`).
2. **Git installiert** (unter Windows: Git for Windows; unter Linux: `sudo apt install git` o.ä.).
3. **Obsidian CLI** installiert und so konfiguriert, dass sie deinen Vault kennt (z.B. über eine Konfig‑Datei oder CLI‑Argumente).
4. Der Vault‑Pfad ist für alle Agents identisch (z.B. bei mehreren OS über Sync‑Ordner wie Dropbox, Syncthing, OneDrive).

---

## 1. Claude Code – Installation von `obsidian-skills`

### 1.1. Installation über Marketplace (empfohlen)

Diese Befehle werden **innerhalb von Claude Code** im Command‑Interface ausgeführt, nicht im System‑Terminal:

```text
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills
```

Dadurch werden alle Obsidian‑Skills (u.a. **obsidian-cli**, **obsidian-markdown**, **obsidian-bases**) für Claude Code verfügbar.

### 1.2. Alternative: Manuelle Installation (Linux & Windows)

1. **Repo in deinen Vault klonen**

   Im System‑Terminal (Linux oder Windows) in das **Root deines Obsidian‑Vaults** wechseln:

   ```bash
   cd /pfad/zu/deinem/vault        # Linux
   # Beispiel: cd ~/Vault

   cd D:\Pfad\Zu\Vault             # Windows (PowerShell/CMD)
   ```

2. **Repo in `.claude` klonen**

   ```bash
   git clone https://github.com/kepano/obsidian-skills.git .claude
   ```

   Ergebnis: Im Vault liegt ein Verzeichnis `./.claude/skills/<skill-name>/SKILL.md`.

3. **Claude Code auf diesen Vault zeigen**

   In Claude Code:

   - Projekt/Workspace so wählen, dass der **Working Directory** dein Vault ist, oder
   - den Pfad zu `.claude` im Tool‑Setup/Projekt‑Settings hinterlegen, falls unterstützt.

4. **Skill nutzen**

   In Claude Code nach **`obsidian-cli`** suchen (z.B. über Befehls‑Palette oder Skill‑Übersicht) und für die Session aktivieren.

---

## 2. OpenCode – Installation von `obsidian-skills`

### 2.1. Globale Installation (Linux)

OpenCode sucht global typischerweise unter:

- `~/.config/opencode/skills/`

Installation:

```bash
mkdir -p ~/.config/opencode/skills
git clone https://github.com/kepano/obsidian-skills.git ~/.config/opencode/skills/obsidian-skills
```

Wichtig: Das Repo **vollständig** klonen, damit die Struktur lautet:

```text
~/.config/opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md
```

OpenCode beim nächsten Start:

- lädt alle `SKILL.md` automatisch
- stellt u.a. **`obsidian-cli`** als Skill zur Verfügung

### 2.2. Globale Installation (Windows)

Unter Windows liegt der globale OpenCode‑Skill‑Pfad meist in deinem Roaming‑Profil, z.B.:

- `%APPDATA%\opencode\skills\`
  – oft: `C:\Users\<User>\AppData\Roaming\opencode\skills\`

Vorgehen (PowerShell oder CMD):

```powershell
mkdir "%APPDATA%\opencode\skills"  2> NUL
git clone https://github.com/kepano/obsidian-skills.git "%APPDATA%\opencode\skills\obsidian-skills"
```

Auch hier: komplette Repo‑Struktur beibehalten.

### 2.3. Projektbezogene Installation (Linux & Windows)

Alternativ kannst du Skills **nur für ein spezifisches Projekt** bereitstellen:

1. In dein Projekt‑Verzeichnis wechseln:

   ```bash
   cd /pfad/zu/deinem/projekt      # Linux
   cd D:\Pfad\Zu\Projekt           # Windows
   ```

2. Repo unter `.opencode/skills` klonen:

   ```bash
   mkdir -p .opencode/skills
   git clone https://github.com/kepano/obsidian-skills.git .opencode/skills/obsidian-skills
   ```

OpenCode erkennt beim Start im Projekt automatisch:

```text
./.opencode/skills/obsidian-skills/skills/<skill>/SKILL.md
```

### 2.4. Gemeinsamer Vault für Claude Code & OpenCode

Damit beide denselben **Informationsspeicher** nutzen:

- Claude Code zeigt auf einen Vault mit `.claude/` und Obsidian‑Skills.
- OpenCode nutzt denselben Ordner, oder
- du referenzierst die gleiche Skills‑Quelle (z.B. `~/.claude/skills`, `~/.config/opencode/skills`) in der jeweiligen Agent‑Konfiguration.

---

## 3. Hermes – Verwendung desselben Obsidian‑Skill‑Stacks

Da es für Hermes unterschiedliche Implementierungen gibt, hier ein generisches Vorgehen, das für die meisten „Skill‑fähigen“ Coding Agents funktioniert:

### 3.1. Installation über Skills‑CLI (wenn vorhanden)

Viele Agents nutzen einen generischen Skills‑Installer auf Basis von `npx` oder ähnlichen CLI‑Tools. Typische Form:

```bash
npx skills add https://github.com/kepano/obsidian-skills
# oder, wenn Hermes explizit unterstützt wird:
npx ai-agent-skills install kepano/obsidian-skills --agent hermes
```

Dies:

- registriert das Repo bei deinem Agent
- macht alle enthaltenen Skills (inkl. `obsidian-cli`) verfügbar
- erfordert meist einen Neustart/Reload von Hermes

### 3.2. Manuelle Installation (Linux & Windows)

Falls Hermes eine eigene Skills‑Ordnerstruktur nutzt (z.B. `~/.hermes/skills` oder projektbezogen `./.hermes/skills`), kannst du analog vorgehen:

1. Global (Linux):

   ```bash
   mkdir -p ~/.hermes/skills
   git clone https://github.com/kepano/obsidian-skills.git ~/.hermes/skills/obsidian-skills
   ```

2. Global (Windows):

   ```powershell
   mkdir "%APPDATA%\hermes\skills"  2> NUL
   git clone https://github.com/kepano/obsidian-skills.git "%APPDATA%\hermes\skills\obsidian-skills"
   ```

3. Projektbezogen:

   ```bash
   mkdir -p .hermes/skills
   git clone https://github.com/kepano/obsidian-skills.git .hermes/skills/obsidian-skills
   ```

Danach:

- Hermes neu starten
- In der Skill‑Übersicht `obsidian-cli` aktivieren
- sicherstellen, dass Hermes denselben Obsidian‑Vault‑Pfad nutzt wie Claude Code & OpenCode.

---

## 4. Gemeinsamer Informationsspeicher für alle drei (Best Practice)

Damit **Claude Code**, **OpenCode** und **Hermes** denselben Speicher verwenden:

1. **Einen zentralen Vault definieren**

   Beispiel:

   - Linux: `~/KnowledgeVault`
   - Windows: `D:\KnowledgeVault`
   - oder ein synchronisierter Ordner (Nextcloud, Syncthing, Dropbox etc.)

2. **Obsidian‑Skills einmalig im Vault verankern**

   Im Vault‑Root:

   ```bash
   cd /pfad/zu/deinem/vault   # oder entsprechender Windows-Pfad
   git clone https://github.com/kepano/obsidian-skills.git .claude
   ```

   Dadurch:

   - liegen alle Skills unter `./.claude/skills/...`
   - sowohl Claude Code als auch OpenCode & Hermes können diese Struktur nutzen, wenn sie `.claude`‑kompatibel sind oder du die Pfade in der Konfiguration referenzierst.

3. **Agents auf denselben Pfad konfigurieren**

   - In Claude Code: Projekt/Workspace = Vault‑Pfad.
   - In OpenCode:
     - entweder ebenfalls im Vault arbeiten,
     - oder `~/.config/opencode/skills` auf ein gemeinsames Repo zeigen, das du dort ebenfalls geklont hast.
   - In Hermes:
     - Pfad zum Vault und/oder Skills‑Ordner in der Konfiguration so setzen, dass er den gleichen Vault und das gleiche Skills‑Repo verwendet.

4. **Obsidian CLI auf denselben Vault konfigurieren**

   - CLI‑Konfiguration so setzen, dass sie auf diesen Vault zeigt.
   - Alle drei Agents rufen `obsidian-cli` auf, welches wiederum immer mit diesem Vault arbeitet.

---

## 5. Kurze Copy‑Paste‑Sektion (für Bookstack als „Cheat Sheet“)

```text
# Gemeinsamer Obsidian-Skill-Stack für Claude Code, OpenCode, Hermes

Voraussetzungen:
- Obsidian installiert, Vault vorhanden
- Git installiert
- Obsidian CLI konfiguriert für denselben Vault

## Claude Code

# Marketplace (empfohlen)
(plugin-Befehle in Claude Code ausführen)
  /plugin marketplace add kepano/obsidian-skills
  /plugin install obsidian@obsidian-skills

# Manuell (Linux/Windows, im Terminal)
  cd /pfad/zu/vault
  git clone https://github.com/kepano/obsidian-skills.git .claude

## OpenCode (Linux global)
  mkdir -p ~/.config/opencode/skills
  git clone https://github.com/kepano/obsidian-skills.git ~/.config/opencode/skills/obsidian-skills

## OpenCode (Windows global)
  mkdir "%APPDATA%\opencode\skills"  2> NUL
  git clone https://github.com/kepano/obsidian-skills.git "%APPDATA%\opencode\skills\obsidian-skills"

## OpenCode (projektbezogen, Linux/Windows)
  cd /pfad/zu/projekt
  mkdir -p .opencode/skills
  git clone https://github.com/kepano/obsidian-skills.git .opencode/skills/obsidian-skills

## Hermes (generisch, wenn Skills-CLI vorhanden)
  npx skills add https://github.com/kepano/obsidian-skills
  # oder
  npx ai-agent-skills install kepano/obsidian-skills --agent hermes

## Hermes (manuell, Beispielpfad)
  mkdir -p ~/.hermes/skills
  git clone https://github.com/kepano/obsidian-skills.git ~/.hermes/skills/obsidian-skills

Hinweis:
- Alle Agents sollten denselben Vault-Pfad und dieselbe Obsidian-CLI-Konfiguration verwenden,
  damit sie auf einen gemeinsamen Informationsspeicher zugreifen.
```

Wenn du mir noch sagst, welche konkrete Hermes‑Variante du nutzt (VS‑Code‑Extension, Web‑IDE, lokaler CLI‑Agent usw.), kann ich dir das Hermes‑Teilstück noch genauer zuschneiden.