vault

Format conventions for markdown knowledge vaults. Use when writing notes or when format/syntax questions arise. Covers the dual-reader principle (human + AI), YAML frontmatter, wikilinks, and sources.

$ Installer

git clone https://github.com/odysseus0/nix-config /tmp/nix-config && cp -r /tmp/nix-config/users/tengjizhang/claude/skills/vault ~/.claude/skills/nix-config

// tip: Run this command in your terminal to install the skill

SKILL.md

View on GitHub →

name: vault description: Format conventions for markdown knowledge vaults. Use when writing notes or when format/syntax questions arise. Covers the dual-reader principle (human + AI), YAML frontmatter, wikilinks, and sources.

Vault Format

Dual-Reader Principle

Notes are read by both humans (via Obsidian/editors) and AI (raw markdown). Write so both have a good experience.

Avoid:

Dataview blocks (AI sees dead code)
Content that depends on embeds ![[]] resolving
Heavy callout syntax

Use freely:

Wikilinks [[Note Title]] (both can follow)
YAML frontmatter (both can parse)
Standard markdown

Note Structure

---
tags:
  - tag1
  - tag2
---

# Title

Content here.

## Sources
- (Author, Year) for claims

Conventions

Frontmatter: YAML with 3-7 specific tags

Links: Inline wikilinks [[Note Title]] or [[Note Title|display text]]

No separate "Related Notes" section - links belong in context

Sources: Inline attribution (Author, Year), full references in ## Sources section