Skip to main content

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:

/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:

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

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

  2. Repo in .claude klonen

    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:

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:

~/.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):

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:

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

  2. Repo unter .opencode/skills klonen:

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

OpenCode erkennt beim Start im Projekt automatisch:

./.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:

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):

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

  2. Global (Windows):

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

  3. Projektbezogen:

    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:

    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“)

# 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.

Back to top