Communitygithub.com

heyitsnoah/claudesidian

Interaktiver Setup-Assistent, der neuen Benutzern hilft, eine personalisierte CLAUDE.md-Datei basierend auf ihren Obsidian-Workflow-Präferenzen zu erstellen.

Was ist claudesidian?

Dieses Skill ist ein umfassender Einrichtungsassistent, der Claude Code, Cursor, Codex, OpenCode und Pi-basierte KI-Agenten durch die Erstellung einer personalisierten CLAUDE.md-Konfiguration führt, die auf den Obsidian-Workflow eines Benutzers zugeschnitten ist. Es ersetzt das herkömmliche manuelle Bootstrapping durch ein interaktives Wizard-Erlebnis, das die Vault-Struktur analysiert, die Organisation nach der PARA-Methode erkennt, persönliche Projekte und Verantwortungsbereiche abfragt und optionale Tools wie Gemini Vision für die Bildanalyse und Firecrawl für die Websuche einrichtet. Das Skill erkennt automatisch vorhandene Obsidian-Vaults in Standardpfaden, importiert deren Konfiguration bei Bedarf und erstellt die komplette Ordnerstruktur gemäß den Benutzervorgaben. Es unterstützt mehrere Obsidian-Vaults durch klare Nummerierung und Auswahlbestätigung, sodass selbst bei mehreren gefundenen Vaults kein Konflikt entsteht. Die generierte CLAUDE.md enthält personalisierte Arbeitsabläufe für tägliche Routinen, Projektmanagement und wöchentliche Reviews. Zu den Kernfunktionen gehören die Überprüfung des Git-Status, die Installation von Abhängigkeiten, die Erstellung von README-Dateien für Projekte und Verantwortungsbereiche sowie die optionale Einrichtung von MCP-Servern für erweiterte Fähigkeiten. Das Skill konzentriert sich darauf, durch Vorlagen und interaktive Fragen einen produktiven Kontext für KI-gestützte Arbeit mit Obsidian zu schaffen, mit besonderem Augenmerk auf die Integration von Claude Code, Cursor und anderen populären KI-Entwicklungswerkzeugen.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add https://github.com/heyitsnoah/claudesidian/tree/HEAD/.agents/skills/init-bootstrap

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Bootstrap-Konfiguration initialisieren

Dieser Befehl hilft Ihnen, eine personalisierte CLAUDE.md-Konfigurationsdatei zu erstellen, indem er Fragen zu Ihrem Obsidian-Workflow und Ihren Präferenzen stellt.

Aufgabe

Lesen Sie die CLAUDE-BOOTSTRAP.md-Vorlage und sammeln Sie interaktiv Informationen über:

  • Vorhandene Vault-Struktur (falls vorhanden)
  • Workflow-Präferenzen
  • Notizstil
  • Organisationsmethoden
  • Spezifische Anforderungen

Erstellen Sie anschließend eine maßgeschneiderte CLAUDE.md-Datei, die auf ihre Bedürfnisse zugeschnitten ist.

Prozess

  1. Initiale Umgebungseinrichtung

    • Aktuelles Datum mit date-Befehl für Zeitstempel abrufen
    • Aktuellen Ordnernamen prüfen und fragen, ob sie ihn umbenennen möchten
    • Wenn ja, durch das Umbenennen führen (Verschieben des übergeordneten Verzeichnisses handhaben)
    • Nach package.json suchen und Abhängigkeiten installieren:
      • Zuerst pnpm install versuchen (schneller, besser)
      • Auf npm install zurückfallen, wenn pnpm nicht verfügbar
    • Überprüfen, ob Kernabhängigkeiten installiert sind
    • Git-Status prüfen:
      • Wenn kein .git-Ordner: Git-Repository initialisieren
      • Wenn Remote-Origin vorhanden: Nach Entwicklungsarbeit fragen
        • Persönlicher Vault: Origin und .github-Ordner entfernen
        • Mitwirkung: Origin und Workflows intakt lassen
      • Wenn sauberes lokales Repo: Bereit
    • Noch keine Ordner erstellen – warten, bis nach der Organisationsmethode gefragt wurde
  2. Vorhandene Konfiguration prüfen

    • Nach vorhandener CLAUDE.md suchen
    • Falls vorhanden: Fragen, ob sie aktualisiert oder neu begonnen werden soll
    • Nach CLAUDE-BOOTSTRAP.md-Vorlage suchen
  3. Vault-Informationen sammeln

    • Übliche Speicherorte nach vorhandenen Obsidian-Vaults durchsuchen (.obsidian-Ordner)
    • Diese Pfade mit angemessenen Tiefenbeschränkungen prüfen:
      • ~/Documents (maxdepth 3) – alle Plattformen
      • ~/Desktop (maxdepth 3) – alle Plattformen
      • ~/Library/Mobile Documents/iCloud~md~obsidian/Documents (maxdepth 5 – nur macOS, iCloud-Vaults)
      • Home-Verzeichnis ~/ (maxdepth 2) – alle Plattformen
      • Aktuelles Verzeichnis übergeordnet (maxdepth 2) – alle Plattformen
    • Wenn gefunden: Frage: "Obsidian-Vault unter [Pfad] gefunden. Ist dies der Vault, den Sie importieren möchten?"
    • Dateien korrekt zählen: find [path] -type f -name "*.md" | wc -l (keine Tiefenbeschränkung)
    • Vault-Größe anzeigen: du -sh [path]
    • Wenn bestätigt, Vault-Struktur analysieren:
      • tree -L 3 -d [path] ausführen, um Ordnerhierarchie zu sehen
      • 10-15 zufällige Notizen stichprobenartig prüfen, um Inhaltstypen zu verstehen
      • 30-50 aktuelle Dateinamen auflisten, um Namensmuster zu erkennen
      • Nach täglichem Notizordner und Format suchen
      • Aktivste Ordner nach Dateianzahl identifizieren
      • Erkennen, ob PARA, Zettelkasten, Johnny Decimal oder benutzerdefiniert verwendet wird
    • Wenn nicht der richtige oder keiner gefunden:
      • Nur auf macOS: Frage: "Wird Ihr Vault in iCloud Drive gespeichert? (ja/nein)"
      • Wenn ja (macOS): "Bitte geben Sie den vollständigen Pfad zu Ihrem Vault ein (z.B. /Library/Mobile Documents/iCloudmd~obsidian/Documents/IhrVault)"
      • Wenn nein, oder auf Linux/Windows: "Bitte geben Sie den Pfad zu Ihrem vorhandenen Vault ein, oder geben Sie 'überspringen' ein, um neu zu beginnen"
      • Benutzerdefinierte Pfade validieren (siehe Abschnitt "Benutzerpfad-Validierung" unten)
    • Wenn kein vorhandener Vault oder Benutzer überspringt, beginnen sie neu
  4. Konfigurationsfragen stellen

    • "Wie heißen Sie?" (für Personalisierung)
    • "Möchten Sie, dass ich Ihre öffentliche Arbeit recherchiere, um Ihren Kontext besser zu verstehen?"
      • Wenn ja: Nach Informationen suchen
      • IMMER Ergebnisse anzeigen und fragen "Ist das korrekt?" zur Bestätigung
      • Wenn mehrere Personen gefunden, nummeriert zur Auswahl auflisten
      • Wenn falsche Person, erneute Suche oder Überspringen anbieten
      • Relevante Informationen über ihre Arbeit, ihren Schreibstil, Fachgebiete speichern
    • "Folgen Sie der PARA-Methode oder haben Sie ein anderes Organisationssystem?"
    • "Was sind Ihre Hauptanwendungsfälle? (Forschung, Schreiben, Projektmanagement, Wissensdatenbank, tägliche Notizen)"

    Bei Verwendung von PARA, spezifische Einrichtungsfragen stellen: PARA-Methode von Tiago Forte

    • "An welchen aktiven Projekten arbeiten Sie gerade?" (Ordner in 01_Projects erstellen)
    • "Welche Verantwortungsbereiche verwalten Sie?" (z.B. Arbeit, Gesundheit, Finanzen, Familie)
    • "Welche Themen recherchieren Sie häufig?" (In 03_Resources einrichten)
    • "Haben Sie kürzlich abgeschlossene Projekte?" (Kann mit Zusammenfassungen archiviert werden)

    Allgemeine Präferenzen:

    • .obsidian/community-plugins.json prüfen, um zu sehen, welche Plugins verwendet werden
    • Vorhandene Dateien analysieren, um Namenskonvention automatisch zu erkennen
    • Nach Anhangsordner suchen, um zu sehen, ob mit Mediendateien gearbeitet wird
    • "Verwenden Sie Git zur Versionskontrolle?"
    • "Gibt es bestimmte Websites oder Ressourcen, auf die Sie häufig verweisen?"
    • "Haben Sie bestimmte Vorlieben für Ihren Schreibstil?"
    • "Gibt es Arbeitsabläufe oder Muster, die Claude befolgen soll?"
    • "Möchten Sie ein wöchentliches Review-Ritual? (z.B. Donnerstag Projekt-Review)"
    • "Bevorzugen Sie den 'Denkmodus' (Fragen/Erkundung) vs. den 'Schreibmodus'?"
  5. Optionale Tool-Einrichtung

    Gemini Vision (bereits enthalten)

    • Frage: "Gemini Vision ist bereits für die Analyse von Bildern, PDFs und Videos enthalten. Möchten Sie es aktivieren? (ja/nein/später)"
    • Erklärung: "Sie benötigen nur einen kostenlosen API-Schlüssel von Google. Dadurch kann Claude jeglichen visuellen Inhalt in Ihrem Vault analysieren."
    • Wenn später: "Kein Problem! Sie können es jederzeit einrichten, indem Sie einen API-Schlüssel von https://aistudio.google.com/apikey holen und GEMINI_API_KEY zu Ihrem Shell-Profil hinzufügen, dann claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs ausführen."
    • Wenn ja:
      • Anleitung zum Abrufen des API-Schlüssels von https://aistudio.google.com/apikey (kostenlos, dauert 30 Sekunden)
      • Hilfe beim Hinzufügen zum Shell-Profil (.zshrc, .bashrc usw.)
      • claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs ausführen
      • .mcp.json mit API-Schlüssel konfigurieren
      • Verbindung mit einem Beispielbefehl testen

    Firecrawl (bereits enthalten)

    • Frage: "Firecrawl ist für die Websuche enthalten. Möchten Sie es einrichten? (ja/nein/später)"
    • Erklärung: "Das ist ein Game-Changer für die Forschung! Wenn Sie einen Artikel oder eine Website finden, können Sie ihn/sie direkt als Markdown in Ihrem Vault speichern – den Inhalt für immer bewahren, durchsuchbar machen und von Claude analysieren lassen. Perfekt für den Aufbau einer Forschungsbibliothek."
    • Beispiel: "Sagen Sie einfach zu Claude: 'Speichere diesen Artikel in meinem Vault: [URL]' und es ist erledigt!"
    • Wenn später: "Sie können es jederzeit einrichten, indem Sie einen API-Schlüssel von https://firecrawl.dev holen und die Skripte in .scripts/ konfigurieren."
    • Wenn ja:
      • Anleitung zum Abrufen des API-Schlüssels von https://firecrawl.dev (kostenloser Tarif verfügbar)
      • Hilfe bei der Konfiguration der Skripte in .scripts/
      • Beispielverwendung zeigen: .scripts/firecrawl-scrape.sh https://example.com
  6. Benutzerdefinierte Konfiguration generieren

    • Aktuelles Datum abrufen: date +"%B %d, %Y" für die CLAUDE.md-Überschrift
    • Präferenzen in .claude/vault-config.json speichern:
      {
        "user": {
          "name": "Max Mustermann",
          "background": {
            "companies": ["Firma1", "Firma2"],
            "roles": ["Mitgründer", "Autor"],
            "publications": ["Warum ist das interessant?", "every.to"],
            "expertise": [
              "Entwicklerwerkzeuge",
              "Marketing-Technik",
              "Systemdenken"
            ],
            "interests": ["KI zum Denken", "Notizsysteme", "Kreativität"]
          },
          "profileSources": [
            "https://example.com/ueber-mich",
            "https://every.to/@benutzername"
          ],
          "customContext": "Konzentriert sich auf KI als Denkverstärkung, nicht nur zum Schreiben",
          "publicProfile": true
        },
        "vaultPath": "/pfad/zum/existierenden/vault",
        "fileNamingPattern": "erkanntes-muster",
        "organizationMethod": "PARA",
        "primaryUses": ["Forschung", "Schreiben", "Projekte"],
        "tools": {
          "geminiVision": true,
          "firecrawl": false
        },
        "projects": ["Buch - Produktivität", "SaaS-App"],
        "areas": ["Newsletter", "Gesundheit"],
        "importedAt": "2025-01-13",
        "lastUpdated": "2025-01-13"
      }
      
    • Mit CLAUDE-BOOTSTRAP.md als Basis beginnen
    • Benutzerspezifische Abschnitte hinzufügen:
      • Benutzerdefinierte Ordnerstruktur mit tatsächlichen Projekten/Bereichen
      • Persönliche Arbeitsabläufe
      • Bevorzugte Werkzeuge und Skripte
      • Spezifische Richtlinien
      • MCP-Konfiguration, falls eingerichtet
    • Ihre Websites/Ressourcen einfügen, falls angegeben
    • Benutzerdefinierte Namenskonventionen hinzufügen
    • Mit ihren Projekten und Bereichen vorausfüllen:
      • Projektordner in 01_Projects/ erstellen
      • Bereichsordner in 02_Areas/ erstellen
      • Ressourcenthemen in 03_Resources/ erstellen
      • README-Dateien hinzufügen, die jedes Projekt/jeden Bereich erklären
  7. Vorhandenen Vault importieren (falls zutreffend)

    • Wenn Benutzer vorhandenen Vault hat:
      • OLD_VAULT-Ordner erstellen: mkdir OLD_VAULT
      • Kompletten Vault unter Strukturerhalt kopieren: cp -r [vault-path]/* ./OLD_VAULT/
      • Obsidian-Konfiguration kopieren: cp -r [vault-path]/.obsidian ./
      • Nach anderen wichtigen Dateien suchen und kopieren:
        • .trash/ (Obsidians Papierkorb)
        • .smart-connections/ (falls dieses Plugin verwendet wird)
        • Arbeitsbereichsdateien: .obsidian.vimrc usw.
      • Überspringen beim Kopieren: .git/ (sie haben ihr eigenes), .claude/ (wir verwenden unseres)
      • Zusammenfassung anzeigen: "Vault nach OLD_VAULT/ importiert (X Dateien, Y Ordner)"
      • Erklärung: "Ihre ursprüngliche Struktur bleibt in OLD_VAULT erhalten. Sie können nach Bedarf schrittweise Dateien in die PARA-Ordner migrieren."
  8. Unterstützende Dateien erstellen

    • Anfängliche Ordnerstruktur generieren, wenn neuer Vault
    • README-Dateien für Hauptordner erstellen
    • Für jeden Projektordner Unterordner erstellen:
      • Research/ (Quellenmaterial)
      • Chats/ (KI-Gespräche)
      • Daily Progress/ (Laufendes Protokoll)
    • 05_Attachments/Organized/-Verzeichnis erstellen
    • .gitignore einrichten, wenn Git verwendet wird (.mcp.json, node_modules einschließen)
    • Anfängliche Vorlagen erstellen, falls gewünscht
    • WEEKLY_REVIEW.md erstellen, wenn Benutzer Review-Ritual wünscht
    • FIRST_RUN-Markierungsdatei entfernen, falls vorhanden
    • Ersten Git-Commit durchführen, wenn Repository initialisiert wurde
  9. Testbefehle ausführen

    • pnpm vault:stats ausführen, um Skripte zu überprüfen
    • Anhangsbefehle testen, wenn Ordner existieren
    • MCP-Tools testen, wenn konfiguriert
    • Überprüfen, ob Git Dateien korrekt verfolgt
  10. Nächste Schritte bereitstellen

  • Zusammenfassung dessen, was erstellt und konfiguriert wurde
  • Kurzanleitung spezifisch für ihr Setup
  • Liste der verfügbaren Befehle, die sie verwenden können
  • Testbefehle, um zu überprüfen, ob alles funktioniert
  • Vorschläge für erste Aufgaben basierend auf ihren Anwendungsfällen
  • Wie die Konfiguration später geändert werden kann

Beispielausgabe

# Ihre Obsidian-Vault-Konfiguration

Generiert am: [Führen Sie `date +"%B %d, %Y"` aus, um aktuelles Datum zu erhalten] Zuletzt aktualisiert: [Gleiches Datum] Basierend auf Ihren Präferenzen für: [Hauptanwendungsfälle] Einrichtung abgeschlossen mit: ✅ Abhängigkeiten ✅ Ordnerstruktur ✅ Git initialisiert

## Ihre benutzerdefinierte Ordnerstruktur

[Ihre spezifische Struktur mit Erklärungen]

## Ihre Arbeitsabläufe

### Tägliche Routine

[Basierend auf ihren Antworten]

### Projektmanagement

[Ihr spezifischer Ansatz]

### Forschungsmethode (Noah Brier Style)

- Alles festhalten, was Sie lesen
- Wichtige Ideen natürlich wieder auftauchen lassen
- Mit Schreiben beginnen, um Verständnis zu testen
- Suche, nicht Tags, verwenden, um Dinge zu finden
- [Mehr über Noahs System erfahren](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452)

### Wöchentliches Review-Ritual

[Wenn aktiviert: Jeden Donnerstag um 16 Uhr alle Projekte überprüfen]

## Ihre Präferenzen

### Dateibenennung

- Muster: [ihre Konvention]
- Beispiele: [spezifische Beispiele]

### Werkzeuge und Skripte

[Relevante Skripte für ihren Workflow]

## MCP-Server (falls konfiguriert)

### Gemini Vision

- Status: ✅ Konfiguriert und getestet
- API-Schlüssel: In .mcp.json festgelegt
- Test mit: `Verwende gemini-vision, um [Bildpfad] zu analysieren`

## Verfügbare Befehle

### Vault-Verwaltung

- `pnpm vault:stats` – Vault-Statistiken anzeigen
- `pnpm attachments:list` – Unverarbeitete Anhänge auflisten
- `pnpm attachments:organized` – Organisierte Dateien zählen

### Claude-Fähigkeiten

Fähigkeiten werden automatisch erkannt, wenn Sie die Aufgabe beschreiben. Beispiele:

- "Hilf mir, X zu durchdenken" → `thinking-partner`
- "Fasse meinen Tag zusammen" / "Tägliches Review" → `daily-review`
- "Verarbeite meinen Posteingang" → `inbox-processor`
- "Führe das Setup-Wizard erneut aus" → `init-bootstrap`

Fähigkeiten leben in `.agents/skills/` (kanonisch) mit Symlinks in `.claude/skills/` und `.pi/skills/`. Sie arbeiten in Claude Code, OpenCode, Codex, Cursor und Pi.

## Kurzanleitung

1. [Personalisierter erster Schritt]
2. [Nächste Aktion basierend auf ihren Zielen]
3. [Spezifisch für ihren Workflow]

## Profi-Tipps von Forschungsmeistern

- **Seien Sie ein Token-Maximalist**: Geben Sie Claude viel Kontext
- **Schreiben skaliert**: Dokumentieren Sie alles für zukünftige Referenz
  ([Noah Brier](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452))
- **Vertrauen Sie auf Emergenz**: Wichtige Ideen werden immer wieder auftauchen
- **Beginnen Sie mit Schreiben**: Starten Sie Projekte immer in Textform
- **Regelmäßig überprüfen**: Nehmen Sie sich wöchentlich Zeit zum Beschneiden und Aktualisieren
- **PARA-Methode**: Projekte, Bereiche, Ressourcen, Archiv
  ([Tiago Forte](https://fortelabs.com/blog/para/))

## Einrichtungszusammenfassung

✅ Abhängigkeiten installiert (pnpm/npm) ✅ Ordnerstruktur erstellt ✅ Git-Repository initialisiert und vom Original getrennt ✅ CLAUDE.md personalisiert ✅ Erstmaliges Setup abgeschlossen [✅ MCP Gemini Vision konfiguriert – falls eingerichtet] [✅ Erster Commit durchgeführt – falls Git initialisiert wurde]

Wichtige Implementierungshinweise

Umgang mit mehreren Vaults

Wenn mehrere Vaults erkannt werden:

  1. Alle gefundenen Vaults immer auflisten mit klarer Nummerierung und Details
  2. Explizite Auswahl anfordern – nicht annehmen, welcher Vault verwendet werden soll
  3. Auswahl bestätigen, bevor mit dem Import fortgefahren wird
  4. Mehrdeutige Antworten behandeln – wenn der Benutzer unklare Eingaben macht (z.B. einen Screenshot einfügt), nach Klärung fragen:
    • "Ich sehe, Sie haben einen Screenshot geteilt. Könnten Sie bitte die Nummer (1-3) des Vaults eingeben, den Sie importieren möchten?"
    • "Ich brauche eine klare Auswahl. Bitte geben Sie '1', '2' oder '3' ein, um einen Vault auszuwählen."

Verwandte Skills