bob_query

Execute read-only Dataview queries against Obsidian vaults via the bob CLI.

5|Updated Dec 6, 2021
One-click install
npx skills add https://github.com/bbugyi200/dotfiles --skill bob-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bob_query
Source: https://github.com/bbugyi200/dotfiles/tree/main/home/dot_codex/skills/bob_query
Command: npx skills add https://github.com/bbugyi200/dotfiles --skill bob-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the need for manual navigation and parsing of large Obsidian vaults by providing a structured, read-only interface for querying vault data.

Core Features & Use Cases

  • Read-Only DQL Execution: Safely run Dataview Query Language (DQL) commands against the Bob vault without risking data integrity.
  • Flexible Output Formatting: Generate results in Markdown for human readability or path-only lists for programmatic processing.
  • Use Case: Quickly retrieve a list of all notes tagged with a specific project status or extract metadata from a collection of research files without opening the Obsidian application.

Quick Start

Use the bob_query skill to run a markdown-formatted query from a file named query.dql against the default vault.

Frequently Asked Questions about bob_query

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

FAQPage Schema
How do I query an Obsidian vault without opening the application?

You can query an Obsidian vault by executing read-only Dataview Query Language commands via the command line, retrieving structured note metadata directly. This bypasses manual navigation by programmatically parsing vault content.

What is the best way to extract metadata from Obsidian research files?

The best way to extract metadata is running read-only DQL queries against the vault to fetch structured note properties. This programmatic access safely retrieves metadata collections without risking data integrity.

Can I output Dataview query results in Markdown format?

Yes, you can format Dataview query results in Markdown for human readability or as path-only lists for programmatic processing. This flexible output formatting supports both administrative review and automation workflows.

Do I need the bob command-line interface to run DQL commands?

Yes, the bob command-line interface is required to parse Dataview Query Language and return results. It acts as the execution engine that safely processes read-only queries against your Obsidian vault files.

Is it safe to run Dataview queries against a live Obsidian vault?

Running read-only DQL execution is safe for live vaults because it retrieves structured note metadata without modifying the original data. This eliminates the risk of altering data integrity during administrative or research tasks.

How to retrieve a list of notes tagged with a specific project status in Obsidian?

Retrieve tagged notes by executing a Dataview query filtering for that specific project status. This programmatic method quickly extracts targeted metadata collections from large vaults without manual navigation.