obsidian-notes
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
About this skill
This skill provides AI agents with the capability to programmatically interact with Obsidian vaults. It leverages `obsidian-cli`, a command-line interface tool, to perform operations such as searching for notes by name or content, creating new notes with specified content, and managing default vaults. An Obsidian vault is treated as a standard folder containing Markdown files, making it accessible and interoperable. Agents can use this skill to streamline tasks related to knowledge management, content creation, and information retrieval within Obsidian. By abstracting the file system interactions, it allows AI to seamlessly integrate with a user's existing Obsidian setup, whether for personal documentation, project notes, or research. The skill ensures that agents follow best practices for Obsidian interaction, such as reading vault configurations from `obsidian.json` and avoiding hardcoded paths. Key functionalities include setting and printing the default vault, powerful search capabilities (by note name or content with snippets), and creating new notes. This makes it an essential tool for any user who wants to extend the power of AI into their Obsidian-based workflow.
Best use case
The primary use case for this skill is to empower AI agents to automate and enhance tasks within Obsidian, benefiting users who rely on Obsidian for personal knowledge management, research, or project documentation. It's ideal for quickly finding information, generating new content, or organizing notes without manual intervention.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Users can expect seamless programmatic interaction with their Obsidian notes, enabling automated content management, search, and creation tasks via an AI agent.
Practical example
Example input
Search my default Obsidian vault for all notes mentioning 'AI agent best practices' and provide a summary of the key takeaways from the first 5 search results.
Example output
Found 3 notes related to 'AI agent best practices': 'Agent Principles.md', 'Prompt Engineering Tips.md', 'Ethical AI Deployment.md'. Key takeaways include focusing on clear task definition, iterating on prompts, and considering ethical implications for successful agent deployment.
When to use this skill
- To programmatically search for information across your Obsidian notes and vaults.
- When you need to automate the creation of new notes or append content to existing ones.
- For integrating your Obsidian knowledge base with other AI-driven workflows or tools.
- To manage your default Obsidian vault settings via script or agent command.
When not to use this skill
- When performing complex visual interactions within the Obsidian desktop application (e.g., graph view, plugin UI).
- If Obsidian is not installed or the `obsidian-cli` command-line tool is not available on your system.
- For direct manipulation of Obsidian's internal configuration files (e.g., `.obsidian/` settings) that are not exposed via `obsidian-cli`.
- If you prefer manual, direct editing of Markdown files without needing automation.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/obsidian-notes/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How obsidian-notes Compares
| Feature / Agent | obsidian-notes | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | easy | N/A |
Frequently Asked Questions
What does this skill do?
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
How difficult is it to install?
The installation complexity is rated as easy. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
ChatGPT vs Claude for Agent Skills
Compare ChatGPT and Claude for AI agent skills across coding, writing, research, and reusable workflow execution.
Best AI Skills for ChatGPT
Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.
SKILL.md Source
# Obsidian Obsidian vault = a normal folder on disk. Vault structure (typical) - Notes: `*.md` (plain text Markdown; edit with any editor) - Config: `.obsidian/` (workspace + plugin settings; usually don't touch from scripts) - Canvases: `*.canvas` (JSON) - Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.) ## Find the active vault(s) Obsidian desktop tracks vaults here (source of truth): - `~/Library/Application Support/obsidian/obsidian.json` `obsidian-cli` resolves vaults from that file; vault name is typically the **folder name** (path suffix). Fast "what vault is active / where are the notes?" - If you've already set a default: `obsidian-cli print-default --path-only` - Otherwise, read `~/Library/Application Support/obsidian/obsidian.json` and use the vault entry with `"open": true`. Notes - Multiple vaults common (iCloud vs `~/Documents`, work/personal, etc.). Don't guess; read config. - Avoid writing hardcoded vault paths into scripts; prefer reading the config or using `print-default`. ## obsidian-cli quick start Pick a default vault (once): - `obsidian-cli set-default "<vault-folder-name>"` - `obsidian-cli print-default` / `obsidian-cli print-default --path-only` Search - `obsidian-cli search "query"` (note names) - `obsidian-cli search-content "query"` (inside notes; shows snippets + lines) Create - `obsidian-cli create "Folder/New note" --content "..." --open` - Requires Obsidian URI handler (`obsidian://…`) working (Obsidian installed). - Avoid creating notes under "hidden" dot-folders (e.g. `.something/...`) via URI; Obsidian may refuse. Move/rename (safe refactor) - `obsidian-cli move "old/path/note" "new/path/note"` - Updates `[[wikilinks]]` and common Markdown links across the vault (this is the main win vs `mv`). Delete - `obsidian-cli delete "path/note"` Prefer direct edits when appropriate: open the `.md` file and change it; Obsidian will pick it up.
Related Skills
obsidian
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli. And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS.
Obsidian CLI 探索记录
Skill for the official Obsidian CLI (v1.12+). Complete vault automation including files, daily notes, search, tasks, tags, properties, links, bookmarks, bases, templates, themes, plugins, sync, publish, workspaces, and developer tools.
Meeting Mastery — AI Meeting Prep, Notes & Follow-Up Engine
You are an elite meeting preparation and follow-up agent. You ensure every meeting is high-value — thoroughly prepared beforehand, cleanly documented during, and actioned after.
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
📝 智能摘要助手 (Smart Summarizer)
Instantly summarize any content — articles, PDFs, YouTube videos, web pages, long documents, or pasted text. Extracts key points, action items, and insights. Use when you need to quickly digest long content, create meeting notes, or extract takeaways from any source.
Customer Onboarding
Systematically onboard new clients with checklists, welcome sequences, milestone tracking, and success metrics. Reduce churn by nailing the first 90 days.
CRM Manager
Manages a local CSV-based CRM with pipeline tracking
Invoice Generator
Creates professional invoices in markdown and HTML
Productivity Operating System
You are a personal productivity architect. Your job: help the user design, execute, and optimize their daily system so they consistently ship high-impact work while protecting energy and avoiding burnout.
Product Launch Playbook
You are a Product Launch Strategist. You guide users through planning, executing, and optimizing product launches — from pre-launch validation through post-launch growth. This system works for SaaS, physical products, services, marketplaces, and content products.
Procurement Manager
You are a procurement specialist agent. Help teams evaluate vendors, manage purchase orders, negotiate contracts, and optimize spend.