claude-obsidian 스킬 뜯어보기 (1): wiki 오케스트레이터

claude-obsidian/
├── skills/wiki/
│   ├── SKILL.md                     # 스킬 본체 — 아키텍처, 라우팅, 핫 캐시
│   └── references/
│       ├── modes.md                  # 6가지 볼트 모드 (A~F)
│       ├── frontmatter.md            # YAML 프론트매터 스키마
│       ├── css-snippets.md           # 시각 커스터마이징 CSS
│       ├── git-setup.md              # Git 초기화 및 백업
│       ├── plugins.md                # 코어 + 커뮤니티 플러그인
│       ├── rest-api.md               # Local REST API 사용법
│       └── mcp-setup.md             # MCP 서버 4가지 옵션
└── commands/
    └── wiki.md                       # /wiki 커맨드 — 부트스트랩 워크플로우

The wiki is the product. Chat is just the interface.
 
The key difference from RAG: the wiki is a persistent artifact.
Cross-references are already there. Contradictions have been flagged.
Synthesis already reflects everything read.
Knowledge compounds like interest.

vault/
├── .raw/       # Layer 1: immutable source documents
├── wiki/       # Layer 2: LLM-generated knowledge base
└── CLAUDE.md   # Layer 3: schema and instructions (this plugin)

wiki/
├── index.md            # master catalog of all pages
├── log.md              # chronological record of all operations
├── hot.md              # hot cache: recent context summary (~500 words)
├── overview.md         # executive summary of the whole wiki
├── sources/            # one summary page per raw source
├── entities/           # people, orgs, products, repos
│   └── _index.md
├── concepts/           # ideas, patterns, frameworks
│   └── _index.md
├── domains/            # top-level topic areas
│   └── _index.md
├── comparisons/        # side-by-side analyses
├── questions/          # filed answers to user queries
└── meta/               # dashboards, lint reports, conventions

---
type: meta
title: "Hot Cache"
updated: YYYY-MM-DDTHH:MM:SS
---
 
# Recent Context
 
## Last Updated
YYYY-MM-DD. [what happened]
 
## Key Recent Facts
- [Most important recent takeaway]
- [Second most important]
 
## Recent Changes
- Created: [[New Page 1]], [[New Page 2]]
- Updated: [[Existing Page]] (added section on X)
 
## Active Threads
- User is currently researching [topic]

| User says                           | Operation    | Sub-skill      |
|-------------------------------------|-------------|----------------|
| "scaffold", "set up vault"          | SCAFFOLD    | this skill     |
| "ingest [source]", "add this"       | INGEST      | wiki-ingest    |
| "what do you know about X"          | QUERY       | wiki-query     |
| "lint", "health check"              | LINT        | wiki-lint      |
| "save this", "/save"                | SAVE        | save           |
| "/autoresearch [topic]"             | AUTORESEARCH| autoresearch   |
| "/canvas"                           | CANVAS      | canvas         |

# [WIKI NAME]: LLM Wiki
 
Mode: [MODE A/B/C/D/E/F]
Purpose: [ONE SENTENCE]
Owner: [NAME]
Created: YYYY-MM-DD
 
## Structure
[PASTE THE FOLDER MAP FROM THE CHOSEN MODE]
 
## Conventions
- All notes use YAML frontmatter
- Wikilinks use [[Note Name]] format
- .raw/ contains source documents: never modify them
- wiki/index.md is the master catalog
- wiki/log.md is append-only: never edit past entries
- New log entries go at the TOP of the file
 
## Operations
- Ingest: drop source in .raw/, say "ingest [filename]"
- Query: ask any question
- Lint: say "lint the wiki"
- Archive: move cold sources to .archive/

## Wiki Knowledge Base
Path: ~/path/to/vault
 
When you need context not already in this project:
1. Read wiki/hot.md first (recent context, ~500 words)
2. If not enough, read wiki/index.md (full catalog)
3. If you need domain specifics, read wiki/[domain]/_index.md
4. Only then read individual wiki pages

wiki/
├── pages/         # one note per URL
├── structure/     # site architecture, nav hierarchy
├── audits/        # content gaps, redirect needs
├── keywords/      # keyword clusters
└── entities/      # brand, authors, topic hubs

type: page
url: "https://example.com/page-slug"
status: live          # live | redirect | 404 | stub | no-index
word_count: 0
has_schema: false
indexed: true
internal_links_in: 0
internal_links_out: 0
last_crawled: YYYY-MM-DD

wiki/
├── modules/       # one note per major module / package
├── components/    # reusable UI or functional components
├── decisions/     # Architecture Decision Records (ADRs)
├── dependencies/  # external deps, versions, risk assessment
└── flows/         # data flows, request paths, auth flows

type: module
path: "src/auth/"
status: active         # active | deprecated | experimental | planned
language: typescript
depends_on: []
used_by: []

wiki/
├── stakeholders/  # people, companies, decision-makers
├── decisions/     # key decisions with rationale
├── deliverables/  # milestones, outputs, status tracking
├── intel/         # competitor analysis, market research
└── comms/         # synthesized meeting notes

wiki/
├── goals/         # personal and professional goals
├── learning/      # concepts being mastered
├── people/        # relationships, shared context
├── areas/         # health, finances, career, creative
└── resources/     # books, courses, tools

wiki/
├── papers/        # paper summaries with key claims
├── concepts/      # extracted concepts, models, frameworks
├── entities/      # people, organizations, methods, datasets
├── thesis/        # evolving synthesis pages
└── gaps/          # open questions, contradictions

type: paper
status: summarized     # raw | summarized | synthesized | superseded
year: 2024
authors: []
key_claim: ""
methodology: ""
contradicts: []
supports: []

wiki/
├── characters/    # characters, personas, experts
├── themes/        # major themes with evidence
├── concepts/      # domain-specific terms
├── timeline/      # plot structure, curriculum sequence
└── synthesis/     # your own takeaways

type: concept
status: developing     # stub | developing | mature
source_chapters: []
first_appearance: ""

- "GitHub repo + research on the AI approach used"
  → Mode B folders + Mode E papers/ folder
- "My SaaS business + second brain"
  → Mode C intel/ + Mode D goals/
- "YouTube channel"
  → Mode F (content as "book") + Mode E (research on topics)

Every wiki page starts with flat YAML frontmatter.
No nested objects. Obsidian's Properties UI requires flat structure.

---
type: <source|entity|concept|domain|comparison|question|overview|meta>
title: "Human-Readable Title"
created: 2026-04-07
updated: 2026-04-07
tags:
  - <domain-tag>
  - <type-tag>
status: <seed|developing|mature|evergreen>
related:
  - "[[Other Page]]"
sources:
  - "[[.raw/articles/source-file.md]]"
---

seed → developing → mature → evergreen

source_type: article    # article | video | podcast | paper | book | transcript | data
author: ""
date_published: YYYY-MM-DD
url: ""

confidence: high        # high | medium | low
key_claims:
  - "First key claim from this source"

entity_type: person     # person | organization | product | repository | place
role: ""
first_mentioned: "[[Source Title]]"

complexity: intermediate  # basic | intermediate | advanced
domain: ""
aliases:
  - "alternative name"

subjects:
  - "[[Thing A]]"
  - "[[Thing B]]"
dimensions:
  - "performance"
  - "cost"
  - "ease of use"
verdict: "One-line conclusion."

question: "The original query as asked."
answer_quality: solid   # draft | solid | definitive

subdomain_of: ""        # leave empty for top-level domains
page_count: 0

1. Dates as YYYY-MM-DD strings, not ISO datetime.
2. Wikilinks in YAML fields must be quoted: "[[Page Name]]".

:root {
  --wiki-1: #4fc1ff;   /* domains — 파랑 */
  --wiki-2: #c586c0;   /* entities — 보라 */
  --wiki-3: #dcdcaa;   /* concepts — 노랑 */
  --wiki-4: #ce9178;   /* sources — 주황 */
  --wiki-5: #6a9955;   /* questions — 초록 */
  --wiki-6: #d16969;   /* comparisons — 빨강 */
  --wiki-7: #569cd6;   /* meta — 파랑 */
}

.nav-folder-title[data-path^="wiki/domains"]     { color: var(--wiki-1); }
.nav-folder-title[data-path^="wiki/entities"]    { color: var(--wiki-2); }
.nav-folder-title[data-path^="wiki/concepts"]    { color: var(--wiki-3); }
.nav-folder-title[data-path^="wiki/sources"]     { color: var(--wiki-4); }
.nav-folder-title[data-path^="wiki/questions"]   { color: var(--wiki-5); }
.nav-folder-title[data-path^="wiki/comparisons"] { color: var(--wiki-6); }
.nav-folder-title[data-path^="wiki/meta"]        { color: var(--wiki-7); }
.nav-folder-title[data-path=".raw"]              { color: #808080; opacity: 0.6; }

.callout[data-callout='contradiction'] {
  --callout-color: 209, 105, 105;
  --callout-icon: lucide-alert-triangle;
}
.callout[data-callout='gap'] {
  --callout-color: 220, 220, 170;
  --callout-icon: lucide-help-circle;
}
.callout[data-callout='key-insight'] {
  --callout-color: 79, 193, 255;
  --callout-icon: lucide-lightbulb;
}
.callout[data-callout='stale'] {
  --callout-color: 128, 128, 128;
  --callout-icon: lucide-clock;
}

> [!contradiction] 출처 간 충돌
> [[Page A]] claims X. [[Page B]] says Y. Needs resolution.

> [!gap] 소스 부족
> This topic has no source yet. Consider finding one.

> [!key-insight] 핵심 인사이트
> The most important takeaway from this section.

> [!stale] 오래된 주장
> This claim may be outdated. Source was from 2022.

| Query                    | Color               |
|--------------------------|---------------------|
| path:wiki/domains        | Blue (#4fc1ff)      |
| path:wiki/entities       | Purple (#c586c0)    |
| path:wiki/concepts       | Yellow (#dcdcaa)    |
| path:wiki/sources        | Orange (#ce9178)    |
| path:wiki/questions      | Green (#6a9955)     |
| path:.raw                | Gray (dimmed)       |

The color scheme looks best with the Minimal theme.
Install via Settings → Appearance → Manage → search "Minimal".

cd "$VAULT_PATH"
git init
git add -A
git commit -m "Initial vault scaffold"

.obsidian/workspace.json
.obsidian/workspace-mobile.json

.smart-connections/
.obsidian-git-data
.trash/
.DS_Store

Auto backup interval: 15 minutes
Auto backup after file change: on
Push on backup: on (if you have a remote)
Commit message: vault: auto backup {{date}}

git remote add origin https://github.com/yourname/your-vault
git push -u origin main

Keep the repo private if the vault contains personal notes.

Bases: Native database-like views for .base files.
Powers wiki/meta/dashboard.base. Available since Obsidian v1.9.10.
Replaces Dataview for most wiki use cases.

Templater: Auto-populate frontmatter on note creation from _templates/.

Calendar: Right-sidebar calendar with word count, task, and link indicators.
Pre-installed in this vault via .obsidian/plugins/calendar/.

Thino: Quick memo capture panel in right sidebar.
Pre-installed via .obsidian/plugins/thino/.

Minimal Theme: Best dark theme for dense information display.

Dataview (optional/legacy): Only needed if you're on Obsidian < 1.9.10
or want to use the legacy dashboard.md queries.
The primary dashboard now uses Bases.

The Obsidian Web Clipper browser extension converts
web articles to markdown and sends them to .raw/ in one click.
Set the default folder to .raw/ in the extension settings.

API="https://127.0.0.1:27124"
KEY="your-api-key-here"

curl -sk \
  -H "Authorization: Bearer $KEY" \
  "$API/vault/wiki/index.md"

curl -sk -X PUT \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: text/markdown" \
  --data-binary @local-file.md \
  "$API/vault/wiki/entities/Name.md"

curl -sk -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: text/markdown" \
  --data "- New log entry" \
  "$API/vault/wiki/log.md"

curl -sk -X PATCH \
  -H "Authorization: Bearer $KEY" \
  -H "Operation: replace" \
  -H "Target-Type: frontmatter" \
  -H "Target: status" \
  -H "Content-Type: application/json" \
  --data '"mature"' \
  "$API/vault/wiki/concepts/Name.md"

curl -sk -X PATCH \
  -H "Authorization: Bearer $KEY" \
  -H "Operation: append" \
  -H "Target-Type: heading" \
  -H "Target: Connections" \
  -H "Content-Type: text/markdown" \
  --data "- [[New Page]]" \
  "$API/vault/wiki/entities/Name.md"

curl -sk -X POST \
  -H "Authorization: Bearer $KEY" \
  "$API/search/simple/?query=machine+learning"

curl -sk -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/vnd.olrapi.dataview.dql+txt" \
  --data 'TABLE status FROM "wiki" WHERE status = "seed"' \
  "$API/search/"

curl -sk \
  -H "Authorization: Bearer $KEY" \
  "$API/tags/"

curl -sk \
  -H "Authorization: Bearer $KEY" \
  "$API/vault/wiki/entities/"

The plugin runs on https://127.0.0.1:27124 with a self-signed certificate.

{
  "NODE_TLS_REJECT_UNAUTHORIZED": "0"
}

claude mcp add-json obsidian-vault '{
  "type": "stdio",
  "command": "uvx",
  "args": ["mcp-obsidian"],
  "env": {
    "OBSIDIAN_API_KEY": "<YOUR_KEY>",
    "OBSIDIAN_HOST": "127.0.0.1",
    "OBSIDIAN_PORT": "27124",
    "NODE_TLS_REJECT_UNAUTHORIZED": "0"
  }
}' --scope user

claude mcp add-json obsidian-vault '{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@bitbonsai/mcpvault@latest", "/absolute/path/to/your/vault"]
}' --scope user

# Read a note
obsidian-cli read /path/to/vault wiki/index.md
 
# Create or update a note
obsidian-cli write /path/to/vault wiki/new-note.md < content.md
 
# Search notes by content
obsidian-cli search /path/to/vault "query term"

Both MCP options use --scope user so the vault is available
across all Claude Code projects.

1. Check if Obsidian is installed.
2. Check if this directory has a vault (look for .obsidian/ folder).
3. Check if the MCP server is configured (claude mcp list).
4. Ask ONE question: "What is this vault for?"

Ask ONE question: "What is this vault for?"
Then build the entire wiki structure based on the answer.
Don't ask more questions.

- "Map the architecture of github.com/org/repo"           → Mode B
- "Build a sitemap for example.com"                        → Mode A
- "Track my SaaS business"                                 → Mode C
- "Research project on [topic]"                            → Mode E
- "Personal second brain"                                  → Mode D
- "Organize my YouTube channel"                            → Mode F

If the vault is already set up, skip to checking what has been
ingested recently and offering to continue where things left off.