obsidian

Creates formatted markdown notes in an Obsidian vault following existing folder conventions.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/kellymears/agents --skill obsidian-kellymears
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/kellymears/agents/tree/main/plugins/obsidian/skills/obsidian
Command: npx skills add https://github.com/kellymears/agents --skill obsidian-kellymears

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing notes to an Obsidian vault manually requires knowing the vault path, respecting its folder structure, and avoiding duplicate notes. This Skill automates that workflow so notes land in the right place with consistent formatting. ## Core Features & Use Cases - Vault Path Resolution: Resolves the vault location via the OBSIDIAN_VAULT_PATH environment variable or by prompting the user, then caches it for the session. - Convention-Aware Writing: Inspects the vault's existing folder structure, naming patterns, and duplicate notes before writing, so new notes match established conventions. - Obsidian-Native Formatting: Produces markdown with headings, sections, code blocks, tables, and [[wikilinks]] compatible with Obsidian's renderer. - Use Case: Ask to save meeting notes or a how-to guide, and the Skill checks for similar existing notes, picks the right subfolder, and writes a well-structured markdown file. ## Quick Start Ask the assistant to create a note about your chosen topic in your Obsidian vault, optionally specifying a subfolder.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I create a note in my Obsidian vault automatically?▼

Set the OBSIDIAN_VAULT_PATH environment variable or provide the vault path when prompted, then describe the note topic. The Skill checks existing structure and writes a formatted markdown file to the appropriate location.

How to avoid duplicate notes in Obsidian?▼

The Skill searches the vault with a keyword-based find command before writing. If a similar note exists, it offers to update that note instead of creating a duplicate.

Does this work with iCloud-synced Obsidian vaults?▼

Yes, it supports all vaults synced via iCloud, since it writes standard markdown files directly to the vault directory on the local filesystem, which iCloud then syncs.

Can I specify a subfolder for new Obsidian notes?▼

Yes, include a subfolder path in your request, such as guides/. The Skill respects existing folder conventions and places the note at vault-path/subfolder/Title.md.

What markdown formatting does Obsidian note creation use?▼

Notes start with a heading matching the filename, use section headings, fenced code blocks with language identifiers, pipe tables, and [[wikilinks]] for cross-references. YAML frontmatter and emojis are omitted unless requested.