Write notes in Skill formatso that AI can easily explore and load related concepts.
Core Principles
Generated note = Skill structure + Progressive Disclosure
| Stage | Content | AI Usage |
|---|---|---|
| Stage 1 | frontmatter (name, description, keywords) | Relevance assessment |
| Stage 2 | SKILL.md body (summary, easy explanation) | Grasp the essentials |
| Stage 3 | references/ (details, examples) | Load when needed |
Workflow
1. Analyze input content
| Input Type | Processing Method |
|---|---|
| Text/Keywords | Extract topics and organize concepts |
| URL (document) | Analyze content with WebFetch |
| URL (video) | Identify topic based on title/description |
| Image | Analyze and describe image content |
| File path | Read file and analyze content |
2. Search existing notes
Use PageIndex first, fallback to grep/glob:
# Fallback: 키워드로 기존 노트 검색
grep -rl "keywords:.*검색어" . --include="SKILL.md"
grep -rl "related:.*검색어" . --include="SKILL.md"
3. Category matching
Category management See reference.
| Condition | Action |
|---|---|
| Similar note exists | Add link to existing note (bidirectional) |
| Similar category exists | Create note in that category |
| New topic | Create new category/note |
4. Create note
notes/[category]/[topic]/SKILL.mdCreate- If needed,
references/create detailed documents under .claude/skills/[topic]Create symlink- Add backlinks to related existing notes
Generated Structure
notes/
└── [category]/
└── [topic]/
├── SKILL.md # 노트 본문 (Skill 형식)
└── references/ # 상세 내용 (필요시)
└── examples.md
.claude/skills/
└── [topic] -> ../../notes/[category]/[topic]/ # symlink
Required Elements
Must be included in every note:
- Skill frontmatter - name, description, keywords, related
- Summary - Key content in 2-3 sentences
- Easy explanation - Explanation for non-experts
- Related concept links - Obsidian format
[[노트명]] - Tags - Hierarchical tags
Linking Strategy
- No existing note → Empty link
[[미작성 개념]]Create - Existing note present → Update bidirectional links
- Details: Linking Strategy