writing-to-obsidian

Upload project documents to Obsidian Vault with YAML frontmatter.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/Open330/agt --skill writing-to-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-to-obsidian
Source: https://github.com/Open330/agt/tree/main/integrations/obsidian-writer
Command: npx skills add https://github.com/Open330/agt --skill writing-to-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Uploads documents to Obsidian Vault and organizes them by project context, automatically generating metadata for consistent vault structure.

Core Features & Use Cases

  • Automatic project detection from the current directory and saving documents under Vault/workspace/{project}/context
  • Path mapping support via ~/.agents/OBSIDIAN.md to customize Obsidian destinations
  • YAML frontmatter generation for per-project metadata and optional tagging
  • Use case: a developer uploads API design notes to Obsidian with a single command, preserving structure and searchable metadata

Quick Start

Upload a document to Obsidian Vault under the current project context, optionally into a subfolder, with automatic frontmatter creation.

Frequently Asked Questions about writing-to-obsidian

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

FAQPage Schema
How do I auto-upload project notes to Obsidian with YAML frontmatter?

To auto-upload project notes to Obsidian with YAML frontmatter, this tool detects your current project and saves documents under workspace/{project}/context. It automatically handles file naming and folder creation while generating per-project metadata.

Can I customize the destination folder when saving documents to an Obsidian vault?

You can customize Obsidian destination folders by creating a path mapping file at ~/.agents/OBSIDIAN.md. This configuration allows you to override the default workspace structure and route documents into specific subfolders.

Does this tool automatically detect my current project for Obsidian vault uploads?

Yes, the tool automatically detects the current project from your working directory. It uses this context to organize uploaded documents under the correct workspace/{project}/context path in your Obsidian vault.

How do I check my Obsidian vault configuration and set up paths for uploads?

You can check your Obsidian vault configuration and set up paths using the provided simple CLI. This command-line interface helps verify your current setup and manage the destination paths for your project documents.

What is the best way to organize API design notes in Obsidian by project context?

The best way to organize API design notes by project context is using automated frontmatter generation and path mapping. This ensures your documents are consistently structured under workspace/{project}/context with searchable metadata tags.