obsidian-ontology-sync

Extract entities and relationships from Obsidian markdown into an append-only ontology graph.

18|2|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/yuanyuekejiJN/AivoClaw --skill obsidian-ontology-sync-yuanyuekejijn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-ontology-sync
Source: https://github.com/yuanyuekejiJN/AivoClaw/tree/main/extraSkills/obsidian-ontology-sync-1.0.1
Command: npx skills add https://github.com/yuanyuekejiJN/AivoClaw --skill obsidian-ontology-sync-yuanyuekejijn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, pyyaml, jq, python-dateutil, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of turning scattered Obsidian notes into structured, machine-queryable knowledge by automatically extracting entities and relationships and keeping them up to date.

Core Features & Use Cases

  • Automatic extraction (Markdown → ontology): Scans configured Obsidian vault folders and extracts entities (e.g., Person, Organization, Project) plus relationships (e.g., works_at, assigned_to) from note content.
  • Scheduled analysis (ontology → insights): Computes entity/relation statistics and detects quality issues such as missing properties (e.g., people without email) and orphaned entities.
  • Feedback generation (insights → better notes): Produces daily/weekly feedback reports with targeted suggestions for missing information, broken links, and template improvements.
  • Works with cron scheduling: Supports running extraction every few hours plus periodic analysis and feedback.

Quick Start

Ask it to run an extraction dry run so you can preview what entities and relationships would be written to the ontology graph.

Frequently Asked Questions about obsidian-ontology-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract entities and relationships from Obsidian markdown notes?

To extract entities and relationships from Obsidian markdown notes, configure a root SKILL.md file and run sync.py. The Skill scans your vault directories to identify entities like Person or Project and maps relationships such as works_at into an append-only ontology graph file like graph.jsonl.

Can I automate Obsidian knowledge graph updates with cron scheduling?

Yes, you can automate Obsidian knowledge graph updates using cron scheduling. The Skill supports running extraction actions every few hours and periodically triggers analysis and feedback generation to ensure your structured ontology stays synchronized with your personal knowledge management notes.

How does markdown ontology extraction detect data quality issues in my vault?

Markdown ontology extraction detects data quality issues by computing entity and relationship statistics during the analysis phase. It identifies missing properties, such as people without email addresses, and flags orphaned entities to help maintain a clean and queryable knowledge graph.

What's the best way to get targeted feedback for missing information in Obsidian notes?

The best way to get targeted feedback for missing information is to use the Skill's feedback generation action. It produces daily or weekly reports containing specific suggestions for missing properties, broken links, and template improvements based on the extracted ontology insights.

Do I need python3 and jq to sync Obsidian notes into a queryable graph?

Yes, you need python3, jq, pyyaml, and python-dateutil installed to sync Obsidian notes into a queryable graph. These dependencies are required to execute the sync.py script for parsing markdown content and managing the append-only ontology graph output.

Can I preview entity extraction from my Obsidian vault before writing to the graph?

Yes, you can preview entity extraction before writing to the graph by requesting an extraction dry run. This allows you to see exactly which entities and relationships would be extracted from your markdown notes and written to the ontology graph file without modifying it.