obsidian-direct

Purpose

This skill enables direct programmatic access to Obsidian vaults for tasks like file creation, editing, template insertion, Dataview queries, and plugin API calls, allowing automation of note-taking workflows.

When to Use

Use this skill for automating Obsidian interactions in scripts, such as generating daily notes from external data, updating files based on user input, or running Dataview queries to fetch metadata. Apply it in scenarios where manual vault management is inefficient, like in CI/CD pipelines or AI-driven content creation.

Key Capabilities

• Create new files or folders in the vault using specified paths and content.
• Edit existing files by appending, overwriting, or inserting text at specific lines.
• Insert templates (e.g., from a predefined .md template file) into new or existing notes.
• Execute Dataview queries to retrieve or manipulate note metadata.
• Call Obsidian plugin APIs for custom extensions, such as querying plugin-specific data.

Usage Patterns

Invoke the skill via a function call like call_skill('obsidian-direct', subcommand, params), where subcommand is one of: create-file, edit-file, insert-template, run-query, or plugin-call. Always include required params as a dictionary, e.g., {'path': 'notes/file.md', 'content': 'Text here'}. For authenticated actions, pass the API key via env var $OBSIDIAN_API_KEY. Structure calls sequentially: first create a file, then edit it. Use JSON for complex params, e.g., {'query': '{"from": "folder", "where": "file.name contains 'key'"}'}. Avoid concurrent calls to prevent vault conflicts.