Org-roam Note Management

Automates org-roam note creation, search, linking, tagging, and diagnostics via emacsclient.

35|8|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/majorgreys/org-roam-skill --skill org-roam-note-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Org-roam Note Management
Source: https://github.com/majorgreys/org-roam-skill/tree/main/.
Command: npx skills add https://github.com/majorgreys/org-roam-skill --skill org-roam-note-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires org-roam, pandoc, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Managing a Zettelkasten or personal knowledge graph in org-roam can be complex and time-consuming, requiring specific Emacs commands and careful database synchronization. This Skill empowers Claude Code to directly interact with your Emacs-based org-roam system, eliminating manual commands and ensuring all note operations respect org-roam's internal database, preventing data corruption.

Core Features & Use Cases

  • Intelligent Note Creation: Ask Claude to "Create a note about React hooks with tags 'javascript' and 'learning'". The skill handles filename formats, unique IDs, and content formatting (Markdown to Org-mode) automatically.
  • Effortless Knowledge Retrieval: Query your notes with natural language, e.g., "Search my notes for anything about Emacs" or "Show me all backlinks to my React note".
  • Graph Management & Diagnostics: Automatically find orphaned notes, create bidirectional links, manage tags, attach files, and diagnose your org-roam setup for optimal performance.

Quick Start

Once installed and your Emacs daemon is running, simply ask Claude Code natural questions about your notes. For example: "Create a note about 'AI in PKM' with tags 'AI' and 'knowledge-management'." Claude will handle the rest, creating and syncing your note.

Alternatively, you can directly use emacsclient to call functions: emacsclient --eval "(org-roam-skill-create-note "AI in PKM" '("AI" "knowledge_management") "AI can revolutionize personal knowledge management.")"

Frequently Asked Questions about Org-roam Note Management

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

FAQPage Schema
How do I automate note creation and linking in org-roam?

Org-roam note automation creates notes from templates with unique IDs, proper Org-mode structure, and automatic database synchronization via emacsclient. Claude handles filename formatting, UUID generation, and content conversion, then syncs changes to your org-roam database without manual commands.

Can I search and retrieve notes from org-roam using natural language?

Yes. Query your org-roam knowledge graph by title, tag, or content using natural language. The Skill retrieves matching notes and backlinks directly from your Emacs daemon, eliminating manual database queries.

What's the best way to manage a personal knowledge graph in Emacs?

Use org-roam with bidirectional linking, UUID-based IDs, and automatic tagging. This Skill enforces proper Zettelkasten structure—PROPERTIES, ID, and FILETAGS—and handles graph diagnostics, orphaned note detection, and file attachments through emacsclient.

Do I need Emacs running locally to use org-roam automation?

Yes. An Emacs daemon must be running. The Skill communicates via emacsclient to execute org-roam functions, ensuring live database synchronization and preventing corruption from out-of-sync operations.

How do I diagnose org-roam configuration problems?

The Skill analyzes your org-roam setup to identify misaligned structures, missing IDs, database inconsistencies, and orphaned notes. It reports configuration issues and compatibility gaps with capture templates and varying org-roam formats.

Can I attach files and manage tags across notes in org-roam?

Yes. The Skill attaches files to notes, manages FILETAGS, creates bidirectional links, and organizes content across your knowledge graph. All changes sync automatically to the org-roam database via emacsclient.