vault-import

Import external files into an Obsidian vault with generated frontmatter.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ahostbr/dotcodex --skill vault-import-ahostbr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vault-import
Source: https://github.com/ahostbr/dotcodex/tree/main/skills/vault-import
Command: npx skills add https://github.com/ahostbr/dotcodex --skill vault-import-ahostbr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Import external files into the Obsidian vault to centralize note access and preserve provenance.

Core Features & Use Cases

  • Read a source file from a given path using the Read tool.
  • Infer the destination folder (e.g., Research/, Chronicles/, Projects/) or honor a provided --to path, and generate frontmatter with metadata.
  • Write the new note to the vault using vault_write, and confirm the import with path and word count.

Quick Start

Use the vault-import command to bring a local markdown file into your vault.

Frequently Asked Questions about vault-import

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

FAQPage Schema
How do I import external markdown files into my Obsidian vault?▼

To import external files into an Obsidian vault, the Skill reads the source path, infers a destination folder like Research/ or Chronicles/, generates frontmatter metadata, and writes the content directly using vault_write. You can also specify a custom destination path.

Can I specify a custom destination folder when importing documents to Obsidian?▼

Yes, you can specify a custom destination folder when importing documents by providing a --to path. If no path is provided, the Skill automatically infers an appropriate destination like Projects/ or Chronicles/ based on the content.

What frontmatter metadata is generated when importing notes into Obsidian?▼

Importing notes generates frontmatter containing type, title, created, imported, source, and tags. This metadata preserves provenance and centralizes note access within the Obsidian vault.

Does the vault-import Skill work with transcripts and other document formats?▼

Yes, the vault-import Skill handles markdown notes, transcripts, and other documents. It reads the source file from its local path and writes it into the vault, confirming the import with the file path and word count.

What is the best way to centralize external notes and preserve their source information in Obsidian?▼

The best way to centralize external notes and preserve source information is to import them with automatically generated frontmatter. This process captures source details and creation dates, writing the content directly to the vault while confirming the word count.

Why does importing files into Obsidian require generating frontmatter?▼

Generating frontmatter is required when importing files to preserve provenance and ensure proper metadata organization. The frontmatter captures type, title, created, imported, source, and tags, allowing centralized note access within the vault.