64 lines
2.4 KiB
Markdown
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
|