note-save

Save user notes as markdown files with frontmatter in a ~/notes vault.

Updated Feb 9, 2025
One-click install
npx skills add https://github.com/carter2099/.dotfiles-homelab --skill note-save
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: note-save
Source: https://github.com/carter2099/.dotfiles-homelab/tree/main/.claude/skills/note-save
Command: npx skills add https://github.com/carter2099/.dotfiles-homelab --skill note-save

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture essential information by saving it into a centralized ~/notes vault, ensuring deduplication and consistent formatting with frontmatter, while keeping notes organized and searchable.

Core Features & Use Cases

  • Writes a markdown file with frontmatter into the ~/notes/<topic>/ directory and updates the global INDEX.md for quick discovery.
  • Updates existing notes on duplicate topics and commits changes to the vault's git history to preserve provenance.
  • Enforces required frontmatter fields (title, tags, source, created, updated) and ensures dates are current.

Quick Start

Provide the topic or content to save, and note-save will create a markdown note in ~/notes with frontmatter, update INDEX.md, and commit the changes.

Frequently Asked Questions about note-save

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

FAQPage Schema
How do I save markdown notes with frontmatter and auto-indexing?

To save markdown notes with frontmatter and auto-indexing, you provide the topic and content. The system creates a structured markdown file in ~/notes/<topic>/, enforces required frontmatter fields like title and tags, and updates an INDEX.md for quick discovery.

What is the best way to organize markdown notes with git history and deduplication?

Organizing markdown notes with git history and deduplication involves saving files into topic-based directories while validating duplicate topics. The system commits changes to the vault's git history to preserve provenance and updates existing notes rather than creating duplicates.

How does auto-indexing work for a centralized markdown notes vault?

Auto-indexing for a markdown notes vault works by automatically updating a global INDEX.md file every time a note is saved. This ensures all notes stored across various topic-based directories remain quickly discoverable and searchable.

Do I need specific frontmatter fields when saving notes to a tracked vault?

Yes, saving notes to a tracked vault requires specific frontmatter fields. The system strictly enforces title, tags, source, created, and updated fields, ensuring dates are current and consistent across all markdown files for safe persistence.

Can I update existing notes on duplicate topics instead of creating new files?

Yes, you can update existing notes on duplicate topics. The system validates topic deduplication and automatically updates the existing markdown file in the ~/notes vault, committing the changes to git history rather than creating a redundant file.

What happens to git history when saving notes to topic-based directories?

When saving notes to topic-based directories, the system commits all changes directly to the vault's git history. This preserves provenance by tracking updates to existing notes and logging new markdown files as they are created.