13. September 2026 · Von YasKad
kepano/obsidian-skills

Obsidian Skills: einem KI-Agenten beibringen, Obsidian wie ein Mensch zu schreiben

kepano/obsidian-skills · 48.866★ · 3.484 forks

Alles Wissenswerte über kepano/obsidian-skills: das offizielle Agent-Skills-Paket des Obsidian-Teams, das Agenten wie Claude Code, Codex oder OpenCode erlaubt, Obsidian-Markdown, Bases, JSON Canvas zu lesen und zu bearbeiten und das Obsidian-CLI selbst zu steuern.

Ein eindrucksvolles Hero-Bild für einen Artikel über Obsidian Skills, das einen leuchtenden KI-Agenten-Schreiber darstellt, der vor einer riesigen dunklen Obsidian-Bibliothek steht und präzise Markdown-Notizen in leuchtende durchscheinende Dateien schreibt, mit schwebenden Wikilinks, Callouts, Frontmatter-Eigenschaften, Bases-Datenpanels, und JSON-Canvas-Knoten, verbunden durch Neon-Kanten, die Szene kombiniert ein Cyberpunk-Kommandoterminal, eine menschenähnliche Hand aus Licht, und eine Repository-Ordnerstruktur, beschriftet mit symbolischen Skill-Icons, alles gerendert in einer Cyberpunk/Tech-Ästhetik im dunklen Modus mit elektrisch-cyanfarbenen, violetten, und bernsteinfarbenen Neon-Akzenten, ultra-detaillierten Materialien, volumetrischem Glühen, reflektierenden schwarzen Oberflächen, subtiler Tiefenschärfe, kinematografischer Komposition, Auflösung 8K

Was obsidian-skills ist

obsidian-skills ist ein Paket von „Agentenfähigkeiten” (agent skills) für Obsidian, veröffentlicht vom selben Autor, der hinter mehreren Projekten der Plattform steht. Es ist kein Plugin, kein Modell und kein Ausführungswerkzeug: Das Produkt sind Anweisungsdateien in Markdown, eine pro Fähigkeit, die ein mit der Agent-Skills-Spezifikation (agentskills.io/specification) kompatibler Agent lädt, um genau zu wissen, wie gültige Obsidian-Dateien zu schreiben sind.

Sein Zweck ist es, eine konkrete Lücke zu schließen: Ein generalistischer Agent kennt die eigenen Erweiterungen von Obsidian nicht — interne Links vom Typ [[Wikilink]], Einbettungen ![[...]], Callouts > [!note], Eigenschaften (Frontmatter), Bases (.base) oder das JSON-Canvas-Format (.canvas) — und generiert deshalb Notizen, die Obsidian nicht gut rendert oder die Links und Ansichten brechen. obsidian-skills liefert die korrekte Syntax und die Workflows, damit der Agent diese Dateien sicher erzeugt und bearbeitet.

Zum 11. September 2026 dokumentiert das Paket sechs Fähigkeiten: obsidian-markdown, obsidian-bases, json-canvas, obsidian-cli, defuddle und knap. Das README präsentiert sie als kompatibel mit „jedem skills-kompatiblen Agenten” und nennt dabei explizit Claude Code, Codex und OpenCode.

Der Ursprung: ein Autor von Obsidian selbst

Das Repository wurde am 2. Januar 2026 von Steph Ango (kepano) erstellt, dessen GitHub-Konto Obsidian als Arbeitgeber ausweist und zu seinem Blog stephango.com sowie seinem X-Konto @kepano verlinkt. Ango ist außerdem Autor mehrerer prominenter Projekte, die mit der Plattform verbunden sind: das Theme obsidian-minimal (5.373 Sterne), der Extraktor defuddle (9.353 Sterne) und das Farbschema flexoki (3.655 Sterne), außerdem seine persönliche Bibliothek kepano-obsidian (4.504 Sterne). Das macht obsidian-skills zum „First-Party”-Paket: kein externer Ansatz zu Obsidian, sondern die Anleitung, die das Team hinter der Anwendung selbst veröffentlicht, damit Agenten seine Formate und sein CLI korrekt nutzen.

Die frühen Commits sind aufschlussreich. Am 2. Januar 2026 wurden die Fähigkeiten Obsidian Markdown und Bases hinzugefügt (am selben Tag, an dem das Repo erstellt wurde), und am 6. Januar folgte JSON Canvas. Defuddle und obsidian-cli kamen am 10. Februar 2026 hinzu, und knap wurde am 10. September 2026 eingefügt. Das Wachstum verlief von unten nach oben: zuerst die bereits bestehenden Dateiformate, dann die Interaktion mit der Anwendung, und schließlich die Generierung von Vorlagen aus strukturierten Daten.

Philosophie und Prinzipien

Offene Formate, keine geschlossene API. Das README betont, dass die Fähigkeiten das Arbeiten mit „offenen Formaten, einschließlich Markdown, Bases und JSON Canvas” lehren. Die Wette ist, dass ein Agent mit einfachen, lesbaren Dateien arbeiten kann, ohne auf eine proprietäre API angewiesen zu sein.

Exakte Syntax, nicht angenähert. Jede Fähigkeit dokumentiert die vollständige Syntax (Wikilinks, Blöcke, Callouts, Bases-Schemas, JSON-Canvas-1.0-Spezifikation) und vor allem den Verifizierungsschritt: das YAML einer .base validieren, prüfen, dass die fromNode/toNode eines Canvas zu bestehenden Knoten aufgelöst werden, oder bestätigen, dass eine Notiz in der Lesevorschau korrekt gerendert wird.

Eine detaillierte Verifizierungsszene innerhalb einer dunklen Obsidian-Bibliothek, in der ein KI-Agent generierte Notizen vor dem Speichern überprüft, mit schwebenden Validierungspanels, die YAML-Syntaxprüfungen, Wikilink-Auflösung, Canvas-Knotenreferenzen, Callout-Rendering, Eigenschaftsanalyse, und Lesevorschau zeigen, eine durchscheinende Notiz zeigt sowohl rohes Markdown als auch gerendertes Ergebnis nebeneinander, mit subtilen Warn- und Erfolgsleuchten, das Bild vermittelt Präzision, Sicherheit, und Formatierung von menschlicher Qualität, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Multi-agenten-Wiederverwendbarkeit. Durch die Befolgung der Agent-Skills-Spezifikation dient eine einzige Fähigkeit Claude Code, Codex und OpenCode, ohne neu geschrieben zu werden. Das README und der PR #27 („Align skills with Agent Skills spec and Codex”) zeigen, dass Kompatibilität als Anforderung behandelt wird, nicht als Zusatz.

Ein konzeptionelles Bild der Multi-Agenten-Kompatibilität, das ein einziges leuchtendes Agent-Skills-Spezifikationsdokument im Zentrum zeigt, mit drei unterschiedlichen KI-Agenten-Terminals darum herum, jedes Terminal unterschiedlich gestaltet, aber verbunden mit demselben Skill-Ordner, die Agenten sind als abstrakte robotische Schnittstellen statt Logos dargestellt, mit symbolischen Code-Fenstern, Befehlszeilen-Prompts, und Verifizierungsabzeichen, die Komposition betont Portabilität, Standardisierung, und wiederverwendbare Skill-Dateien, die über verschiedene Codierungsagenten hinweg funktionieren, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Komponierbarkeit mit angrenzenden Werkzeugen. defuddle (sauberes Markdown aus einer Webseite extrahieren) und knap (Vorlagen aus JSON/CSV rendern) integrieren sich in denselben Ablauf: erfassen, transformieren, und in der Bibliothek speichern, was den Tokenverbrauch reduziert.

Wie es funktioniert

Das Paket ist ein skills/-Ordner mit einem Unterverzeichnis pro Fähigkeit, jedes mit einer SKILL.md (Frontmatter mit name und description) und, in manchen Fällen, zusätzlichen Referenzdateien:

FähigkeitZieldateiWas sie dem Agenten beibringt
obsidian-markdown.mdWikilinks, Einbettungen, Callouts, Eigenschaften, %%...%%-Kommentare, Hervorhebung, LaTeX-Mathematik, Mermaid und Fußnoten.
obsidian-bases.baseBases als YAML-Dateien mit filters (and/or/not), formulas, summaries und Ansichten table/cards/list/map.
json-canvas.canvasJSON-Canvas-1.0-Spezifikation: nodes und edges, eindeutige 16-stellige hexadezimale IDs, fromNode/toNode, Anker fromSide/toSide.
obsidian-cliBibliothek (Anwendung)Interaktion mit einer laufenden Obsidian-Instanz über das CLI obsidian: lesen, erstellen, suchen, Notizen, Aufgaben und Eigenschaften verwalten; und Plugins/Themes entwickeln (plugin:reload, dev:errors, dev:screenshot, dev:dom, dev:console, eval).
defuddleWeb → MarkdownSaubere Inhalte mit dem CLI defuddle parse <url> --md extrahieren, um Tokens gegenüber WebFetch zu sparen.
knapDaten → MarkdownVorlagen mit {{ var }}-Variablen, Filtern und {% ... %}-Logik aus JSON/CSV rendern, und Dateistapel generieren.

Eine detaillierte Nahaufnahme einer Obsidian-Markdown-Skill-Datei, die in einem dunklen digitalen Arbeitsbereich leuchtet, zeigt ein durchscheinendes .md-Dokument mit hervorgehobenen Wikilinks, Einbettungen, Callouts, Eigenschaften, Kommentaren, Hervorhebungen, LaTeX-Formeln, Mermaid-Diagrammen, und Fußnoten, dargestellt als elegante Neon-Symbole, ein kleiner KI-Agenten-Cursor korrigiert sorgfältig die Syntax, umgeben von schwebenden Referenzkarten, beschriftet mit abstrakten Icons für Eigenschaft, Einbettung, und Callout, das Bild vermittelt präzises, menschenähnliches Schreiben von Notizen innerhalb von Obsidian, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Eine ultra-detaillierte Visualisierung einer Obsidian-Bases-Skill als leuchtende YAML-Datenmaschine in einem dunklen Cyberpunk-Kontrollraum, eine zentrale .base-Datei zeigt strukturierte Filter, Formeln, Zusammenfassungen, und mehrere Ansichten einschließlich table, cards, list, und map, jede Ansicht gerendert als durchscheinendes Neon-Panel mit winzigen Datenzeilen, Beziehungslinien, und Validierungshäkchen, ein KI-Agent inspiziert das YAML-Schema und bestätigt, dass sich die Ansichten korrekt auflösen, mit sauberer geometrischer Beleuchtung und reflektierenden schwarzen Glasoberflächen, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Ein dramatisches Cyberpunk-Diagramm einer JSON-Canvas-Skill, zeigt eine dunkle Leinwand voller leuchtender rechteckiger Knoten, verbunden durch präzise Neon-Kanten, jeder Knoten enthält eine symbolische hexadezimale ID, und jede Kante trägt kleine Ankermarkierungen für Quell- und Zielseiten, ein KI-Agent verfolgt Verbindungen, um zu überprüfen, dass jede Knotenreferenz zu einem existierenden Objekt aufgelöst wird, die Komposition ähnelt einer neuronalen Schaltplatine aus Glas, Lichtspuren, und Miniatur-Obsidian-Notizen, mit einem Gefühl strukturierten räumlichen Denkens, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Formatfähigkeiten aktivieren sich durch Beschreibung: Das Frontmatter gibt an „verwende dies, wenn der Nutzer Wikilinks, Callouts, Frontmatter, Tags, oder Einbettungen erwähnt”, sodass der Agent entscheidet, wann er sie lädt. obsidian-cli fügt einen Schritt-für-Schritt dokumentierten Plugin-Entwicklungszyklus hinzu (neu laden → Fehler prüfen → mit Screenshot oder DOM verifizieren → Konsole prüfen).

Eine High-Tech-Szene, die eine Obsidian-CLI-Skill als leuchtende Befehlsbrücke zwischen einem KI-Agenten und einer laufenden Obsidian-Anwendung zeigt, ein dunkles Terminalfenster emittiert cyanfarbenes Licht, während es symbolische Befehle zum Lesen, Erstellen, Suchen, Verwalten von Notizen, Aufgaben, und Eigenschaften ausgibt, daneben zeigt eine stilisierte Obsidian-App-Oberfläche Notizen, Plugins, Themes, und Entwicklerwerkzeuge wie Reload, Errors, Screenshot, DOM-Inspektion, Console, und Evaluierungspanels, das Bild vermittelt präzise programmatische Kontrolle und sicheren Entwicklungs-Workflow, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Eine verfeinerte Datenpipeline-Visualisierung für die Defuddle- und Knap-Skills, bei der eine rohe Webseite von links als verworrene Neon-HTML-Struktur eintritt, durch einen sauberen Extraktionskern läuft, und zu einer ordentlichen Markdown-Notiz wird, dann treten JSON- und CSV-Datenströme in eine Vorlagenmaschine mit Variablenklammern und Logikblöcken ein, wodurch ein Stapel generierter Markdown-Dateien entsteht, die Szene fühlt sich an wie eine futuristische Inhaltsraffinerie mit Glasröhren, leuchtenden Partikeln, und minimalen menschenlesbaren Symbolen, betont Token-Effizienz und saubere Transformation, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Offizieller/halboffizieller Status

Ein Paket des Obsidian-Teams selbst. Der Autor identifiziert Obsidian als seinen Arbeitgeber und ist bereits der Schöpfer des Minimal-Themes, von Defuddle und flexoki. In der Praxis ist es die „offizielle” Referenz dafür, wie ein Agent Obsidians Formate schreiben sollte.

De-facto-Standardformat (Agent Skills). Alle Fähigkeiten folgen der agentskills.io/specification, demselben Standard, den Claude Code, Codex und OpenCode verwenden. Das bedeutet, dass das Paket nicht von einem bestimmten Agenten abhängt und auf jede kompatible Implementierung übertragbar ist.

Installierbar aus dem offiziellen Plugin-Marktplatz von Claude Code. Das README bietet /plugin marketplace add kepano/obsidian-skills gefolgt von /plugin install obsidian@obsidian-skills, und das Repo enthält .claude-plugin/marketplace.json und plugin.json (Name obsidian, Version 1.0.1). Die Präsenz im Marktplatz-Mechanismus von Claude impliziert keine Qualitätszertifizierung durch Anthropic, bedeutet aber, dass das Paket über den offiziellen Kanal dieses Agenten verteilt wird.

Abhängigkeit von einer offiziellen Obsidian-Funktion. Die Fähigkeit obsidian-cli stützt sich auf das Obsidian CLI, eine native Funktion der Anwendung, dokumentiert unter help.obsidian.md/cli und vom Unternehmen selbst vorgestellt (Hacker-News-Thread 46961430, „Obsidian Introduces Obsidian CLI”). Mit anderen Worten, ein Teil des Werts des Pakets stammt aus einer Fähigkeit, die Obsidian offiziell bereitstellt.

In der Praxis positioniert dies obsidian-skills als den natürlichen Ausgangspunkt für jeden, der möchte, dass ein Codierungsagent auf einer Obsidian-Bibliothek operiert, bevor Community-Alternativen erwogen werden.

Das Ökosystem

Begleitende Repositorys des Autors

kepano/defuddle — ein HTML→Markdown-Extraktor („Get the main content of any page as Markdown”); 9.353 Sterne und 403 Forks, TypeScript, erstellt am 27. Februar 2025, Seite defuddle.md. Es ist das Werkzeug, das die defuddle-Fähigkeit verwendet. Auf npm verzeichnete das Paket defuddle (Version 0.19.3) 445.470 Downloads zwischen dem 4. und 10. September 2026 und 2.398.182 Downloads im Vormonat. kepano/defuddle-cli — eine frühere CLI-Version, heute markiert als „Moved to the main defuddle repo”; 508 Sterne. obsidianmd/knap — „A simple template language that turns data into Markdown”; 251 Sterne und 6 Forks, TypeScript, erstellt am 21. August 2026, Seite knap.md, gehörend zur Organisation obsidianmd. Auf npm verzeichnete das Paket knap (Version 0.4.2) 705 Downloads in der Woche vom 4. bis 10. September 2026.

Weitere Projekte des Autors: kepano/obsidian-minimal (ablenkungsfreies Theme, 5.373 Sterne), kepano/kepano-obsidian (Vorlage der persönlichen Bibliothek, 4.504 Sterne), kepano/flexoki („inky”-Farbschema, 3.655 Sterne), kepano/clipper-templates (Vorlagen für den Obsidian Web Clipper, 1.442 Sterne), kepano/40-questions (1.666 Sterne), und kepano/datacore (Work-in-progress-Nachfolger von Dataview, 0 Sterne).

Eine expansive Ökosystem-Konstellation, inspiriert vom Obsidian-Skills-Repository, zeigt einen zentralen leuchtenden Repository-Ordner, verbunden mit begleitenden Projekten und Community-Packs, jeder Knoten repräsentiert ein Werkzeug wie einen Web-Extraktor, Vorlagenrenderer, Theme, Farbschema, persönliche Bibliothek, CLI, oder Agenten-Skill-Pack, mit schwachen Diskussionsblasen im Hacker-News-Stil und sternförmigen Metriken, gerendert als abstrakte Lichtsymbole, der Hintergrund ist eine dunkle Cyberpunk-Karte von Repositorys, Pull Requests, und offenen Formatdateien, vermittelt ein wachsendes offiziell und von der Community unterstütztes Ökosystem, dunkler Modus, Cyberpunk/Tech-Ästhetik, Neon-Akzente, ultra-detailliert, Auflösung 8K

Die Installations-Skill: npx skills

Das README installiert auch über npx skills add .... Das npm-Paket skills (Version 1.5.25) entspricht dem Repository vercel-labs/skills, beschrieben als „The open agent skills ecosystem”. Es ist kein Obsidian-Werkzeug, sondern ein generischer Installer des Agent-Skills-Ökosystems, den das README wiederverwendet, um dieses Paket hinzuzufügen.

Community-Ports, Packs und verwandte Projekte

Die Community hat ihr eigenes Set an Packs und Werkzeugen für Agenten erzeugt, die auf Obsidian operieren, mehrere davon erschienen als Show HN auf Hacker News: vladignatyev/brain-map-skill — „Skill for your agent to visualize your gbrain and Obsidian”; HN-Thread 48514124 mit 23 Punkten und 17 Kommentaren (13. Juni 2026). anliberant/obsidian-ai-setup — „Obsidian AI Setup – A production-ready onboarding skill for AI agents”; HN-Thread 48771700 (3. Juli 2026). ballred/obsidian-claude-pkm — „Obsidian and Claude Code PKM Starter Kit”; HN-Thread 46379291 (24. Dezember 2025). axtonliu/axton-obsidian-visual-skills — „Obsidian Visual Skills – Generate Canvas, Excalidraw, Mermaid from Text”; HN-Thread 46970701 (11. Februar 2026). voicetreelab/voicetree — „Obsidian meets Claude Code. A Markdown graph for agents and context”; HN-Thread 46878200 (3. Februar 2026). acertainKnight/project-thoth — „Thoth – Obsidian AI Research Assistant”; HN-Thread 46968889 (11. Februar 2026).

Diese Zahlen sind das, was die Hacker-News-API während dieser Recherche zurückgab; sie stellen keine Qualitäts- oder Kompatibilitätsprüfung jedes Derivats dar.

Schnellstart-Anleitung

Installation und erster Start

# 1) Marktplatz (Claude Code)
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

# 2) npx skills (jeder Agent-Skills-kompatible Agent)
npx skills add git@github.com:kepano/obsidian-skills.git
# oder, falls HTTPS bevorzugt wird:
npx skills add https://github.com/kepano/obsidian-skills

# 3) Manuell
#    - Claude Code: Kopiere den Inhalt des Repos in den Ordner /.claude im Wurzelverzeichnis der Bibliothek.
#    - Codex: Kopiere den Ordner skills/ in den Skills-Pfad von Codex (typischerweise ~/.codex/skills).
#    - OpenCode: Klone das gesamte Repo in das Skills-Verzeichnis von OpenCode:
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

Beim ersten Start erkennt der Agent die verfügbaren SKILL.md-Dateien (OpenCode erkennt automatisch alle SKILL.md-Dateien unter ~/.opencode/skills/ und erfordert keine Änderungen an opencode.json; die Fähigkeiten sind nach einem Neustart von OpenCode aktiv). Von dort aus reicht es, dem Agenten eine Aufgabe zur Bibliothek zu stellen („erstelle eine Notiz”, „durchsuche meine Bibliothek”, „erfasse diese Seite”), und er lädt die relevante Fähigkeit anhand ihrer description.

Gängige Workflows

  • Eine gültige Obsidian-Notiz erstellen. Der Ablauf obsidian-markdown weist den Agenten an: Frontmatter hinzufügen (title, tags, aliases), den Inhalt schreiben, mit [[Wikilink]] für interne Notizen verlinken, mit ![[...]] einbetten, > [!tip]-Callouts hinzufügen, und am Ende überprüfen, dass die Notiz in der Lesevorschau korrekt gerendert wird.
  • Die Bibliothek über die Befehlszeile abfragen. Mit obsidian-cli, um eine Notiz zu lesen: obsidian read file="My Note"; um zu suchen: obsidian search query="search term" limit=10; um eine Aufgabe zum Tagebuch hinzuzufügen: obsidian daily:append content="- [ ] New task".
  • Eine Webseite erfassen und in der Bibliothek speichern. Die Pipeline defuddle + knap:
    defuddle parse https://example.com/article --md --json \
      | knap render template.md --data - -o note.md
    Defuddle liefert den sauberen Inhalt als JSON (title, content, …) und Knap gießt ihn in eine Vorlage, wodurch note.md entsteht.
  • Einen Stapel Notizen aus Daten generieren. Mit knap batch:
    knap batch template.md --data articles.csv --output-dir notes \
      --filename '{{ title | safe_name }}.md'
    Eine CSV-Zeile (oder ein JSON-Objekt) pro Datei, mit --dry-run zur Validierung ohne zu schreiben.

Wesentliche Konfiguration

  • skills/<name>/SKILL.md — die Datei jeder Fähigkeit. Das Frontmatter mit name und description ist das, was der Agent liest, um zu entscheiden, wann er sie aktiviert.
  • Installationspfad pro Agent — /.claude (Claude Code, im Wurzelverzeichnis der Bibliothek), ~/.codex/skills (Codex) oder ~/.opencode/skills/ (OpenCode). Das README besteht darauf, dass man für OpenCode das gesamte Repo klonen muss, nicht nur den inneren Ordner skills/.
  • defuddle und knap (optionale CLIs) — falls nicht installiert, npm install -g defuddle und npm install -g knap (Knap erfordert Node.js 20 oder neuer; funktioniert auch mit npx knap).
  • obsidian CLI — die Fähigkeit obsidian-cli erfordert, dass Obsidian geöffnet ist, um mit der Bibliothek zu interagieren; obsidian help zeigt die verfügbaren Befehle.
  • .claude-plugin/marketplace.json und plugin.json — Plugin-Metadaten für den Marktplatz von Claude Code; werden normalerweise nicht angefasst.

Häufige Fallstricke und Lösungen

  • Das CLI reagiert nicht. Die Fähigkeit obsidian-cli dokumentiert, dass „Obsidian geöffnet sein muss”. Wenn obsidian ... nichts tut, zuerst die Anwendung öffnen.
  • OpenCode sieht die Fähigkeiten nicht. Nur den inneren Ordner skills/ zu kopieren bricht die erwartete Struktur. Das README verlangt, das gesamte Repo zu klonen, sodass der Pfad ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md lautet, und OpenCode neu zu starten.
  • Bases lässt sich nicht rendern. obsidian-bases listet typische Fehler auf: unquotierte YAML-Strings mit Sonderzeichen, unausgeglichene Anführungszeichen in Formelausdrücken, oder das Referenzieren von formula.X ohne X in formulas zu definieren.
  • ID-Kollisionen im Canvas. Die Fähigkeit json-canvas warnt, dass jeder Knoten und jede Kante eine eindeutige 16-stellige hexadezimale ID benötigt und dass jedes fromNode/toNode vor dem Speichern zu einem existierenden Knoten aufgelöst werden muss.
  • defuddle bei .md-URLs. Die description von defuddle gibt explizit an: nicht für URLs verwenden, die mit .md enden; stattdessen direkt WebFetch verwenden. Der PR #41 („Skip defuddle for .md URLs”) verstärkt diese Regel.
  • knap ohne Node 20. Knap erfordert Node.js 20 oder neuer; bei älteren Versionen empfiehlt sich npx knap oder die Aktualisierung der Runtime.

Integrationen und Migration

Durch die Befolgung von agentskills.io/specification integriert sich das Paket unverändert in Claude Code, Codex und OpenCode, und in jeden kompatiblen Agenten; es gibt keine „Migration” zwischen Agenten, nur der Installationspfad ändert sich. obsidian-cli verbindet den Agenten mit der laufenden Anwendung für Live-Operationen und ergänzt die direkte Dateibearbeitung der anderen Fähigkeiten. Defuddle und Knap verketten sich, um Webinhalte zu erfassen und in Notizen zu rendern. Für Vorlagen ist Knap eine Alternative zum Templater-Plugin; für Notizabfragen besetzt Bases das Terrain von Datenplugins wie Dataview (von dem außerdem kepano/datacore als sich in Entwicklung befindlicher Nachfolger existiert).

Zahlen zum Repository

Messung: 11. September 2026, GitHub-API.

KennzahlWert
Sterne48.174
Forks3.437
Echte Abonnenten (Watcher)249
Commits47
Offene Issues laut API71
Hauptsprache(nicht klassifiziert; das Repo ist Markdown)
LizenzMIT
Erstellt2. Januar 2026
Letzter Push10. September 2026

Top-Contributors, nach Anzahl der Beiträge: kepano (31), Ethereal49 (2), und eine breite Gruppe von Mitwirkenden mit jeweils einem Beitrag (popey, mourjo, chiahsien, petersolopov, SDGLBL, shreyas-makes, SublimePeace, thibaultmol, chenminhua, costa92, Vinluo, zillydev, unter anderen). Zwei API-Vorbehalte: watchers_count in der allgemeinen Antwort spiegelt die Sternezahl wider, sodass die Zahl der echten Abonnenten das Feld subscribers_count (249) ist; und open_issues_count (71) kann offene Pull Requests einschließen, sollte also nicht als ausschließliche Issue-Zählung gelesen werden.

Wie man beiträgt

Das Repository enthält keine CONTRIBUTING.md und keinen dokumentierten Test-Harness, und ist ein kleines Projekt (47 Commits). Der effektive Prozess, abgeleitet aus der tatsächlichen Historie zusammengeführter Pull Requests, ist der GitHub-Standard: forken, einen Branch öffnen, einen PR gegen main einreichen. Die Historie zeigt akzeptierte Community-PRs, zum Beispiel #27 (Ausrichtung der Skills an der Agent-Skills-Spezifikation und Codex), #37, #41, #43, #44, #59 (ein Einbettungsbeispiel in Bases), #64 (Überspringen von .md in defuddle), #66, #68 (Korrektur des Bases-Filterschemas), und #94 (Aktualisierung der defuddle-URL zum neuen Repo). In der Praxis sind die Beiträge Syntaxkorrekturen, Schemadokumentation, und Ausrichtung der Multi-Agenten-Kompatibilität, überprüft und zusammengeführt vom Autor.

Wie die Community es aufnahm

Die gesammelten Belege zeigen Adoption und Aktivität, aber es lohnt sich zu differenzieren: Es wurde kein Launch-Thread von obsidian-skills mit breiter, verifizierbarer Diskussion auf Hacker News gefunden. Stattdessen stützt sich der Kontext auf zwei starke Ökosystem-Threads und mehrere Show-HN-Beiträge von Community-Packs.

Der Thread 46961430 „Obsidian Introduces Obsidian CLI” (44 Punkte, 7 Kommentare, 10. Februar 2026) fängt die Rezeption der Funktion ein, auf die sich die Fähigkeit obsidian-cli stützt. Der Nutzer joshstrange wies auf eine konkrete Einschränkung hin: „man muss die UI trotzdem geöffnet halten, damit das CLI funktioniert, was bedauerlich ist”, obwohl „ich die zusätzliche Kontrolle sehr schätze”. presbyterian merkte an, dass vieles davon bereits möglich war, „da es fast vollständig auf reinen Textdateien aufgebaut ist”. Surac fragte, auf welchen Anwendungsfall es abzielte.

Der Thread 44067409 „Show HN: Defuddle, an HTML-to-Markdown alternative to Readability” (418 Punkte, 68 Kommentare, 22. Mai 2025) zeigt die Rezeption des Begleiters defuddle. creakingstairs erzählte, es beim „Durchsehen des Quellcodes des obsidian web-clipper” gefunden zu haben und „beeindruckt von seinen Markdown-Konvertierungsergebnissen” gewesen zu sein. billconan fragte, ob es KI-Modelle „im Hintergrund” verwende. tmpfs erklärte, „dies kürzlich untersucht zu haben und sicherlich nicht beeindruckt von der Qualität der Readability-Implementierungen in verschiedenen Sprachen” zu sein.

Auf der Seite der Community-Packs erreichte Show HN 48514124 („brain-map-skill”) 23 Punkte und 17 Kommentare, und 49394827 („OzBrain, a shared brain for knowledge between agents and your team”) erhielt 93 Punkte und 59 Kommentare — ein Zeichen anhaltenden Interesses daran, Agenten Zugang zu Obsidian-artigen Bibliotheken zu geben. Es wurde keine verifizierbare Kritik an obsidian-skills selbst gefunden, abgesehen von der Einschränkung des CLI (Erfordernis einer geöffneten UI).

obsidian-skills gegenüber anderen Vorschlägen

VorschlagVerifizierbare ÜberschneidungVerifizierbarer Unterschied
kepano/defuddleEin Werkzeug desselben Autors, das obsidian-skills verwendet (Fähigkeit defuddle), um Webseiten als Markdown zu erfassen.Defuddle ist ein eigenständiger HTML→Markdown-Extraktor (9.353 Sterne); obsidian-skills ist das Anweisungsset, das ihn neben anderen Fähigkeiten aufruft.
obsidianmd/knapEin Werkzeug der Organisation obsidianmd, das obsidian-skills verwendet (Fähigkeit knap), um Vorlagen aus Daten zu rendern.Knap ist eine TypeScript-Vorlagenmaschine (251 Sterne); obsidian-skills lehrt den Agenten, Knap zu orchestrieren, ersetzt nicht die Maschine.
Readability (mozilla/readability)Die Baseline der Webinhaltsextraktion, der sich Defuddle (und damit die Pipeline von obsidian-skills) entgegenstellt.Readability ist eine klassische Extraktionsbibliothek; die Pipeline von obsidian-skills ersetzt sie durch Defuddle + Knap, um eine Bibliothek zu befüllen.
Community-PacksSkill-Packs, die einen Agenten auf Obsidian operieren lassen.Drittanbieter-Packs, die sich auf eine Nische konzentrieren (PKM, Onboarding, Visuelles, Wissenskartierung); obsidian-skills ist das eigene Paket des Obsidian-Teams und deckt die offiziellen Formate (Markdown, Bases, Canvas) plus das CLI ab.
Interne Plugins (Templater, Dataview)Decken Vorlagen und Notizabfragen innerhalb der Anwendung ab.Dies sind Obsidian-UI-Plugins; obsidian-skills leitet einen Agenten an, knap und obsidian-bases zu verwenden, um dasselbe Ergebnis per Befehlszeile/Agent zu erreichen.

Der nützlichste Vergleich erfolgt nicht nach Popularität: obsidian-skills sticht hervor, wenn eine „First-Party”-Referenz über die offizielle Obsidian-Syntax für einen plattformübergreifenden Agenten benötigt wird. Ein spezialisiertes Community-Pack kann vorzuziehen sein, wenn das konkrete Ziel (PKM, Visuelles, Kartierung) über das hinausgeht, was die offiziellen Fähigkeiten dokumentieren.

Anwendungsfälle

  • Personen mit einer Obsidian-Bibliothek, die Claude Code, Codex oder OpenCode nutzen, können das Paket übernehmen, damit der Agent Notizen mit korrekten Wikilinks, Einbettungen, Callouts, und Frontmatter erstellt, bearbeitet, und verlinkt, ohne Syntax oder Ansichten zu brechen.
  • Nutzer des Obsidian CLI (und Entwickler von Plugins/Themes) können sich auf die Fähigkeit obsidian-cli stützen, damit der Agent die Bibliothek live liest, durchsucht, und modifiziert, sowie für den Plugin-Entwicklungszyklus.
  • Workflows zur Erfassung und Veröffentlichung von Inhalten können defuddle parse <url> --md --json | knap render ... verketten, um eine Webseite in eine Bibliotheksnotiz zu verwandeln, und knap batch verwenden, um Stapel von Notizen aus CSV/JSON zu generieren.
  • Wer Daten über Notizen verwaltet (Projekte, Aufgaben, Lektüren) kann den Agenten bitten, eine .base mit filters, formulas, und Ansichten table/cards/list/map zu bauen und dabei Obsidian Bases die Rolle der „Datenbank” über dem Markdown zu übertragen.
  • Teams, die standardisieren, wie ein Agent Obsidian schreibt, können dieses Paket (über den Marktplatz von Claude Code oder npx skills) als gemeinsame Referenz verteilen.

Ressourcen


Hinweis: Dieser Artikel kombiniert das README und die SKILL.md-Dateien von obsidian-skills, die Metadaten der GitHub-API, das npm-Register, die Hacker-News-API und das Profil des Autors, konsultiert am 11. September 2026. Sternezahlen, Downloads, und Punkte ändern sich mit der Zeit.

Kommentare