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

64 lines
2.4 KiB
Markdown

# 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:
```bash
ln -s "$(pwd)/skills" ~/.gemini/skills/claude-obsidian
```
Or run the bundled installer:
```bash
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`
## Project Links
- Plugin (public canonical): https://github.com/AgriciDaniel/claude-obsidian
- Community early-access mirror (Pro): https://github.com/AI-Marketing-Hub
- Pattern: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f