obsidian-eval-query

Search and audit Obsidian vault notes using the obsidian eval command.

3|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/raesene/rmm-skills --skill obsidian-eval-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-eval-query
Source: https://github.com/raesene/rmm-skills/tree/main/obsidian-eval-query
Command: npx skills add https://github.com/raesene/rmm-skills --skill obsidian-eval-query

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a comprehensive solution to search, filter, and analyze notes in your Obsidian vault programmatically, eliminating the need for manual searches and enhancing productivity.

Core Features & Use Cases

  • Programmatic Note Search: Perform advanced searches by tag, folder, frontmatter, content, and metadata.
  • Frontmatter Audit: Identify notes missing frontmatter, list tags, count notes, and build custom queries.
  • Critical Syntax Restrictions: Documented guidelines for working with obsidian eval to avoid common pitfalls.
  • Use Case: Imagine you need to find all notes related to 'KubernetesSecurity' across your vault, including inline tags and frontmatter entries.

Quick Start

Use the obsidian eval command to run JavaScript against your vault. For example, to find notes missing the 'Created' field in frontmatter:

obsidian eval code='app.vault.getFiles().filter(f => f.extension === "md").filter(f => app.metadataCache.getFileCache(f).frontmatter && app.metadataCache.getFileCache(f).frontmatter.Created === undefined).map(f => f.path)'

Frequently Asked Questions about obsidian-eval-query

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

FAQPage Schema
How do I search and analyze notes in an Obsidian vault programmatically?

You can search Obsidian notes programmatically by using the `obsidian eval` command to execute JavaScript against your vault, filtering files by tags, folders, and frontmatter. This automates manual retrieval and enhances vault analysis.

How do I find Obsidian notes missing frontmatter fields using JavaScript?

To find Obsidian notes missing frontmatter fields, you can run a JavaScript query via the `obsidian eval` command that fetches markdown files and filters those where the specific metadataCache frontmatter property is undefined. This allows rapid frontmatter auditing across your vault.

Do I need JavaScript knowledge to automate Obsidian vault searches?

Yes, you need a solid understanding of JavaScript and the Obsidian CLI to automate vault searches. This Skill requires writing custom JavaScript queries to filter files, audit metadata, and retrieve specific data from your note collections.

What are the limitations or syntax restrictions when using the obsidian eval command?

When using the `obsidian eval` command, you must follow documented critical syntax restrictions to avoid common pitfalls during frontmatter audits and note searches. Adhering to these guidelines ensures your JavaScript queries execute correctly against the Obsidian vault.

What is the best way to audit tags and frontmatter across an Obsidian vault?

The best way to audit tags and frontmatter across an Obsidian vault is using the `obsidian eval` command with custom JavaScript queries. This allows you to identify notes missing metadata, list tags, count notes, and build custom filters programmatically.