Files
김경종 72dad72703
Tests / Hermetic test suite (push) Has been cancelled
Tests / Skill frontmatter validation (push) Has been cancelled
add claude-obsidian
2026-05-28 10:57:16 +09:00

2.4 KiB

claude-obsidian: Gemini CLI Instructions

This repo is a knowledge base companion that builds persistent, compounding Obsidian wiki vaults using Andrej Karpathy's LLM Wiki pattern. The skills are written in the cross-platform Agent Skills format and work in Gemini CLI / Antigravity alongside Claude Code.

Skills Discovery

Skills live in skills/<name>/SKILL.md. To make them available to Gemini CLI:

ln -s "$(pwd)/skills" ~/.gemini/skills/claude-obsidian

Or run the bundled installer:

bash bin/setup-multi-agent.sh

Skills

Skill What it does
wiki Scaffolds a new vault, manages hot cache, routes to sub-skills
wiki-ingest Reads sources (files, URLs, images) and creates 8-15 wiki pages each
wiki-query Answers questions from the wiki with three depth modes
wiki-lint Health checks: orphans, dead links, stale claims, gaps
save Files the current conversation as a wiki note
autoresearch Autonomous research loop: search → fetch → synthesize → file
canvas Creates and edits Obsidian canvas (.canvas) files
defuddle Cleans web pages before ingest (saves 40-60% tokens)
obsidian-markdown Obsidian Flavored Markdown syntax reference
obsidian-bases Obsidian Bases (.base files): native database views

Trigger Phrases (Examples)

  • "set up wiki" → wiki
  • "ingest this article" → wiki-ingest
  • "ingest https://example.com/article" → wiki-ingest (URL mode)
  • "what do you know about X" → wiki-query
  • "lint the wiki" → wiki-lint
  • "save this conversation" → save
  • "research [topic]" → autoresearch

Vault Conventions

  • .raw/: source documents, immutable (never modify)
  • wiki/: agent-generated knowledge (you own this)
  • wiki/hot.md: recent context cache (~500 tokens), read first at session start
  • wiki/index.md: master catalog
  • .raw/.manifest.json: delta tracking for ingest

Bootstrap

On first session:

  1. Read this file + the project CLAUDE.md
  2. If wiki/hot.md exists, silently read it to restore recent context
  3. Wait for user to type /wiki or ingest or query