One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill obsidian-cloudofgeorge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/cloudofgeorge/AI-hands-Engineer/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill obsidian-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing an Obsidian vault through an AI agent requires consistent, filesystem-first operations: resolving the vault path, reading and searching notes, creating and appending content, and maintaining wikilinks and frontmatter without breaking existing structure. ## Core Features & Use Cases - Vault File Operations: Read, list, search, create, append, and patch Markdown notes using file tools with resolved absolute paths instead of shell commands. - AI Second Brain Staging: Build an organized vault in stages, from PARA-style folder skeletons and metadata schemas to review automation, capture pipelines, no-plugin retrieval, and user guides. - Project Knowledge Management: Consolidate multi-repo projects into canonical source-of-truth notes, capture structured Hermes task briefs, and run scheduled project reviews with strict guardrails. - Use Case: Ask the agent to organize your Obsidian vault as a second brain; it inspects existing notes, creates a timestamped backup, adds templates and dashboards, normalizes frontmatter, and verifies wikilinks before reporting. ## Quick Start Ask the agent to read a note or organize your Obsidian vault, for example: "Search my Obsidian vault for notes about the Veilframe project and create a summary note linking to them."

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search notes in an Obsidian vault with an AI agent?

Use search_files with target "files" for filename patterns or target "content" with a regex and file_glob "*.md" for note contents. Resolve the vault path first, since file tools do not expand shell variables like $OBSIDIAN_VAULT_PATH.

How do I organize Obsidian as an AI second brain?

Follow the staged approach: create a PARA-inspired folder skeleton with templates and dashboards first, then add operational workflows, review automation, capture pipelines, and a no-plugin retrieval layer. Always back up the vault before bulk metadata changes.

Can I append content to an existing Obsidian note?

Yes. Read the note with read_file, then use patch for an anchored append against stable context such as an existing heading, or write_file to rewrite the whole note. A terminal append is acceptable only when no stable anchor exists.

Why do file tools fail with $OBSIDIAN_VAULT_PATH in Obsidian?

File tools do not expand shell environment variables, so paths containing $OBSIDIAN_VAULT_PATH fail. Resolve the variable first via terminal or use the fallback ~/Documents/Obsidian Vault, then pass the concrete absolute path.

Does this approach require installing Obsidian plugins?

No. The retrieval and organization layer is deliberately no-plugin, relying on Markdown, YAML frontmatter, wikilinks, dashboards, filesystem search, and explicit context packs. Plugins like Smart Connections are suggested only after a stable metadata baseline exists.