knowledge-ingest - SKILL.md Agent Skill

name: knowledge-ingest description: Integrate new notes into the knowledge graph. Create PDFs as markdown source notes. Set properties, links, MOC entries. Prefer existing entities, propose new ones as stub notes. trigger: integrier|einordne|ingest|einpflege|knowledge.maintain|wissen.pflege|note.einordne|ordne.ein|pdf.umwandel|pdf.markdown|quelle.*anlegen source: bundled requiredTools: [read_file, read_document, semantic_search, update_frontmatter, write_file, ingest_document, list_files]

Knowledge Ingest

Ordne eine Note systematisch in das bestehende Wissensnetz ein. Bei PDFs und Dokumenten: Erstelle eine vollstaendige Markdown-Repraesentation als Quellen-Note. Befolge diese Schritte IN DER REIHENFOLGE. Ueberspringe keine Schritte.

Step 0: QUELLE ODER NOTE? (Weiche stellen)

Bestimme was du vor dir hast:

PDF/Office-Dokument (im Chat als Attachment, oder als Datei im Vault) → Gehe zu Pfad A: Quellen-Ingest
Bestehende Markdown-Note → Gehe zu Pfad B: Note einordnen

Pfad A: Quellen-Ingest (PDF/Dokument → Markdown-Note)

Das Ziel: Eine vollstaendige Markdown-Repraesentation der Quelle im Vault. Die PDF selbst wird NICHT im Vault gespeichert -- die Markdown-Note IST die Vault-Repraesentation.

A1: LESEN UND VERSTEHEN

Lies das Dokument:

Vault-Datei: read_document
Chat-Attachment: Der Inhalt ist bereits im Kontext (als <attached_document>)

Pruefe die Attribute des <attached_document> Tags:

vault_path → Datei liegt im Vault. Diesen Pfad als Quelle im Frontmatter verwenden.
source_path → Datei liegt ausserhalb des Vaults (z.B. OneDrive, Downloads). Diesen Pfad als Quelle im Frontmatter verwenden.
Keines von beiden → User nach dem Speicherort fragen

Extrahiere:

Metadaten: Autor(en), Jahr, Titel, URL/DOI/ISBN (aus Inhalt, Kopfzeile, oder User-Angabe)
Struktur: Kapitel, Abschnitte, Ueberschriften
Kernaussagen: Was sind die 3-5 wichtigsten Punkte?
Entitaeten: Themen, Konzepte, Personen (wie bei Note-Ingest)

A2: BESTEHENDE ENTITAETEN SUCHEN

Fuer JEDE erkannte Entitaet: semantic_search im Vault.

KRITISCH: Bevorzuge IMMER bestehende Notes. Suche gruendlich bevor du neue Entitaeten vorschlaegst. Wenige starke Hub-Themen sind besser als viele schwache.

A3: VORSCHLAG PRAESENTIEREN (und STOP)

Zeige dem User:

Quellen-Note fuer "[Titel]":

**Dateiname:** Autor-Jahr_Titel.md
**Ordner:** [Quellen-Ordner im Vault, falls erkennbar]

**Frontmatter:**
- Autor: [Name(n)]
- Jahr: [YYYY]
- Titel: [Vollstaendiger Titel]
- Quelle: [Pfad oder URL zur Original-Datei]
- Zusammenfassung: "[1 Satz, max 25 Woerter]"
- Kategorie: Quelle
- Themen: ["[[Thema A]]", "[[Thema B]]"]
- Konzepte: ["[[Konzept X]]"]
- tags: [keyword-1, keyword-2, ...]

**Neue Entitaeten** (noch keine Note im Vault):
- Konzept "Z" -- Stub-Note erstellen? [JA/NEIN]
- Person "W" -- Stub-Note erstellen? [JA/NEIN]

Soll ich die Note so erstellen?

STOP. Warte auf Antwort des Users.

A4: NOTE ERSTELLEN (nach Bestaetigung)

PFLICHT: Nutze ingest_document -- NICHT write_file. Nur ingest_document kann den vollstaendigen Originaltext anhaengen.

Du schreibst NUR den header_content (Frontmatter + Ueberblick + Kernaussagen). Das Tool haengt den vollstaendigen Originaltext AUTOMATISCH an -- du musst ihn NICHT selbst ausgeben.

Parameter:

output_path: IMMER in Inbox/ schreiben (z.B. "Inbox/Webb-2026_Convergence-Outlook.md")
header_content: Dein Frontmatter + Ueberblick (siehe unten)
source_path: Wenn die PDF im Vault liegt (z.B. "Attachements/report.pdf")
attachment_index: Wenn die PDF als Chat-Attachment hinzugefuegt wurde (0 fuer das erste Attachment)

Der header_content hat diese Struktur:

---
Zusammenfassung: "[1 Satz]"
Autor: [Name(n)]
Jahr: [YYYY]
Titel: [Vollstaendiger Titel]
Quelle: "[Pfad oder URL]"
Kategorie:
  - Quelle
Themen: ["[[Thema A]]", "[[Thema B]]"]
Konzepte: ["[[Konzept X]]"]
tags: [keyword-1, keyword-2, keyword-3]
---

## Ueberblick

[3-5 Absaetze: Zentrale These, wichtigste Erkenntnisse, Argumentation, Relevanz.
 Ermoeglicht schnellen Einstieg ohne den gesamten Text zu lesen.]

## Kernaussagen

- [Kernaussage 1]: [Kurze Erlaeuterung]
- [Kernaussage 2]: [Kurze Erlaeuterung]
- [Kernaussage 3]: [Kurze Erlaeuterung]

WICHTIG: Schreibe KEINEN ## Originaltext Abschnitt. Das ingest_document Tool fuegt den vollstaendigen Originaltext automatisch an. Du musst ihn NICHT ausgeben -- das spart Tokens und umgeht Output-Limits.

STRIKTE REGELN fuer Wikilinks im Body

KEIN Wikilink ohne existierende Note oder Stub-Note. Wenn du [[Konzept X]] im Text schreibst, MUSS entweder eine bestehende Note existieren ODER du erstellst eine Stub-Note dafuer in Step A5.
Wikilinks NUR fuer Entitaeten (Themen, Konzepte, Personen, Organisationen, Projekte). NICHT fuer generische Begriffe.
Bestehende Notes verwenden: Wenn semantic_search eine passende Note findet, verwende deren exakten Dateinamen als Wikilink.

A5: VERNETZUNG UND STUB-NOTES (PFLICHT)

Dieser Schritt ist NICHT optional. Fuer JEDE Entitaet die im Frontmatter oder Body als Wikilink referenziert wird:

Existiert bereits? → Nichts zu tun
Existiert nicht? → Stub-Note erstellen (siehe Pfad B, Step 4b)

Das bedeutet: Wenn du 10 Konzepte im Frontmatter listest und 5 davon nicht als Notes existieren, erstellst du 5 Stub-Notes. KEINE dangling Wikilinks hinterlassen.

Abschliessend:

Frage: "Soll ich die PDF-Datei umbenennen? Vorschlag: Autor-Jahr_Titel.pdf" (User muss das extern machen wenn die PDF nicht im Vault liegt)

Pfad B: Note einordnen (bestehende Markdown-Note)

B1: ANALYSE (lies und verstehe)

Lies die Note mit read_file.

Erkenne im Text:

Themen: Uebergeordnete Wissensgebiete (z.B. Philosophie, KI, Projektmanagement)
Konzepte: Spezifische Ideen oder Theorien (z.B. Kategorischer Imperativ, Prompt Injection)
Personen: Erwaehnte oder referenzierte Personen
Projekte: Referenzierte Projekte oder Initiativen
Organisationen: Firmen, Institutionen, Teams

Pruefe das bestehende Frontmatter: Welche Properties sind schon gesetzt? Welche fehlen oder sind leer?

B2: BESTEHENDE ENTITAETEN SUCHEN (immer zuerst!)

Fuer jede erkannte Entitaet: semantic_search im Vault.

KRITISCH: Bevorzuge IMMER bestehende Notes. Suche gruendlich bevor du neue Entitaeten vorschlaegst.

Gibt es schon eine Note zu dieser Person/Thema/Konzept? → Verwende den exakten Dateinamen als [[Wikilink]]
Gibt es aehnliche Themen die zusammengehoeren? → Nutze das bestehende Thema statt ein neues zu erstellen
Die semantic_search zeigt auch "Related concepts (via ontology)" -- nutze diese fuer transitive Entdeckungen

Themen-Disziplin: Wenige starke Hub-Themen sind besser als viele schwache. Erstelle KEIN neues Thema wenn ein bestehendes passt.

B3: VORSCHLAEGE PRAESENTIEREN (und STOP)

Zeige dem User alle Vorschlaege gesammelt. Warte auf Bestaetigung.

Vorschlaege fuer "[Note-Titel]":

**Properties:**
- Themen: ["[[Thema A]]", "[[Thema B]]"]  (alle mit Kategorie: Thema)
- Konzepte: ["[[Konzept X]]"]              (alle mit Kategorie: Konzept)
- Personen: ["[[Person Y]]"]
- Zusammenfassung: "Ein Satz mit max 25 Woertern."
- tags: [keyword-1, keyword-2, keyword-3, ...]

**Neue Entitaeten** (noch keine Note im Vault):
- Konzept "Z" -- Stub-Note erstellen? [JA/NEIN]
- Person "W" -- Stub-Note erstellen? [JA/NEIN]

Moechtest du die Vorschlaege uebernehmen? (Einzelne koennen geaendert oder entfernt werden.)

STOP. Warte auf Antwort des Users.

B4: AUSFUEHRUNG (nach Bestaetigung)

4a: Properties setzen

Nutze update_frontmatter fuer die Note:

Setze nur Properties die der User bestaetigt hat
NIEMALS bestehende Werte ueberschreiben -- nur leere Properties befuellen
Wikilinks in Properties als Array: ["[[Thema A]]", "[[Thema B]]"]

4b: Stub-Notes erstellen (PFLICHT fuer jede bestaetigte neue Entitaet)

Fuer jede neue Entitaet: write_file mit passendem Inhalt.

Stub-Note Struktur:

---
Zusammenfassung: "[1 Satz Erklaerung]"
[Kategorie-spezifische Properties aus dem Vault-Schema]
Kategorie:
  - [Thema/Konzept/Person/Projekt]
tags: [relevante-keywords]
Permanent: false
---

[2-3 Absaetze: Was ist das? Warum ist es relevant?]

## Aspekte und Teilbereiche

- [Aspekt 1]: [Kurze Erklaerung]
- [Aspekt 2]: [Kurze Erklaerung]
- [Aspekt 3]: [Kurze Erklaerung]

## Verbindungen

- Verlinkt von: [[Ausloesende Note]]
- Verwandte Konzepte: [[...]]

Die Stub-Note soll inhaltlich nuetzlich sein (Agent-Wissen + Vault-Kontext), nicht leer.

4c: Vertiefen oder spaeter?

Frage fuer jede neue Stub-Note:

Jetzt vertiefen? → Agent hilft beim Ausarbeiten
Spaeter? → Task anlegen (wenn TaskNotes-Plugin installiert)

Regeln (IMMER einhalten)

KRITISCHE REGELN (Verstoss = fehlerhafter Ingest)

Quellen-Ingest MUSS ingest_document nutzen -- NIEMALS write_file fuer Pfad A. Nur ingest_document haengt den Originaltext an.
Neue Notes IMMER nach Inbox/ -- NICHT nach Notes/. Der User sortiert Notes selbst von Inbox nach Notes.
KEINE bestehenden Notes verschieben -- NIEMALS move_file waehrend eines Ingest. Notes dort lassen wo sie sind.
KEINE bestehenden Notes inhaltlich aendern -- Nur Backlinks/Callouts zu neuen Quellen-Notes ergaenzen (via edit_file), niemals den Kern-Inhalt veraendern.
KEINE dangling Wikilinks -- Jeder [[Wikilink]] im Body oder Frontmatter MUSS auf eine existierende Note zeigen. Wenn die Note nicht existiert, Stub-Note erstellen oder den Wikilink weglassen.
KEIN PDF-Embed als Ersatz -- NIEMALS ![[datei.pdf]] statt Originaltext verwenden.
Themen und Konzepte sind disjunkte Property-Slots:
- Themen: enthaelt ausschliesslich Wikilinks auf Notes mit Kategorie: Thema (breit/generisch, Hub-Note, z.B. [[Agentic AI]]).
- Konzepte: enthaelt ausschliesslich Wikilinks auf Notes mit Kategorie: Konzept (spezifisch/abgegrenzt, z.B. [[AI Agents]]).
- Niemals einen Themen-Hub unter Konzepte listen, niemals ein Konzept unter Themen. Im Zweifel read_file auf die Ziel-Note und ihr Kategorie:-Feld pruefen.
Properties mit Wikilink-Werten IMMER als YAML-Liste schreiben, niemals als String:
- Richtig (Block-Form):
```
Themen:
  - "[[Agentic AI]]"
  - "[[Wissensmanagement]]"
Konzepte:
  - "[[AI Agents]]"
```
- Auch richtig (Flow-Form): Themen: ["[[Agentic AI]]", "[[Wissensmanagement]]"]
- Falsch: Themen: [[Agentic AI]], [[Wissensmanagement]] (komma-getrennter String -- Obsidian parsed das nicht als Liste).
- Falsch: Themen: "[[Agentic AI]]" (Einzelwert als String -- spaetere Ergaenzungen muessten den Type wechseln).
- Auch bei genau einem Wert bleibt es eine Liste mit einem Element.

ALLGEMEINE REGELN

NIEMALS Properties ueberschreiben die bereits einen Wert haben
IMMER bestehende Entitaeten bevorzugen (Vault durchsuchen bevor neue erstellt werden)
Zusammenfassung: Genau 1 Satz, max 25 Woerter, in der Sprache der Note
Keywords/Tags: 5-10 Stueck, deutsch + englisch, Bindestrich-Schreibweise (max 2 Woerter verbunden)
Themen: Restriktiv -- wenige starke Hub-Themen, nicht fuer jede Nuance ein neues Thema
Stub-Notes: Inhaltlich angereichert mit Erklaerung und Aspekten, NICHT leer. Auch Stub-Notes nach Inbox/.
Thema vs. Konzept: Wenn du eine neue Entitaet erstellen musst, unterscheide:
- Thema = Wissensgebiet, Fachbereich. Man kann darin navigieren und entdecken. Beispiele: Philosophie, Agentic AI, Organisationsentwicklung
- Konzept = Idee, Prinzip, Modell. Man kann es in 2-3 Saetzen erklaeren. Beispiele: Kategorischer Imperativ, MCP Protocol, Zettelkasten-Methode
- Im Zweifel: Frage den User ob Thema oder Konzept
Sprache: Properties und Inhalte in der Sprache des bestehenden Vault
Bestaetigung: Alle Aenderungen MUESSEN vom User bestaetigt werden bevor sie geschrieben werden
Kategorie-Property: Den im Vault verwendeten Property-Namen nutzen (z.B. "Kategorie", "Category", "Type"). Beim Quellen-Ingest immer den Wert "Quelle" (bzw. "Source" in englischen Vaults) setzen
Frontmatter sauber halten: Genau ein --- am Anfang, genau ein --- am Ende. KEIN doppelter Separator. Keine leeren Properties ohne Wert (lieber weglassen als ISBN: ohne Wert).