211 lines
4.6 KiB
Markdown
211 lines
4.6 KiB
Markdown
---
|
|
name: knowledge-management
|
|
description: "Knowledge base and note management with Obsidian. Use when: (1) saving information for later, (2) organizing notes and references, (3) finding past notes, (4) building knowledge connections, (5) managing documentation. Triggers: save this, note, remember, knowledge base, where did I put, find my notes on, documentation."
|
|
compatibility: opencode
|
|
---
|
|
|
|
# Knowledge Management
|
|
|
|
Note capture and knowledge organization using Obsidian as the backend.
|
|
|
|
## Status: Active
|
|
|
|
Quick note capture and knowledge organization using Obsidian markdown vault.
|
|
|
|
## Quick Note Capture
|
|
|
|
- Minimal friction capture to Obsidian vault (~/CODEX/)
|
|
- Auto-tagging based on content
|
|
- Link to related notes using WikiLinks
|
|
- Use frontmatter for metadata
|
|
|
|
## Knowledge Retrieval
|
|
|
|
- Fast search using ripgrep across vault
|
|
- Tag-based filtering (#tag syntax)
|
|
- WikiLink connections for related notes
|
|
- Use Obsidian graph view for visual connections
|
|
|
|
## Resource Organization
|
|
|
|
- PARA Resources category management (03-resources/)
|
|
- Topic clustering with folders
|
|
- Archive maintenance (04-archive/)
|
|
- Frontmatter for structured metadata
|
|
|
|
## Documentation Management
|
|
|
|
- Technical docs organization
|
|
- Version tracking via Git
|
|
- Cross-reference linking
|
|
- Template-driven structure
|
|
|
|
## Integration Points
|
|
|
|
- **Obsidian**: Primary storage (Markdown vault at ~/CODEX/)
|
|
- **task-management**: Link notes to projects/areas
|
|
- **research**: Save research findings to Resources
|
|
|
|
## Quick Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `note: [content]` | Quick capture to inbox |
|
|
| `find notes on [topic]` | Search vault with ripgrep |
|
|
| `link [note] to [note]` | Create WikiLink connection |
|
|
| `organize [tag/topic]` | Cluster related notes |
|
|
|
|
## Note Structure
|
|
|
|
### Quick Note Format
|
|
```markdown
|
|
---
|
|
date: 2026-01-27
|
|
created: 2026-01-27T18:30:00Z
|
|
type: note
|
|
tags: #quick-capture #{{topic_tag}}
|
|
---
|
|
|
|
# {{topic}}
|
|
|
|
## Content
|
|
{{note content}}
|
|
|
|
## Related
|
|
- [[Related Note 1]]
|
|
- [[Related Note 2]]
|
|
```
|
|
|
|
### Resource Format
|
|
```markdown
|
|
---
|
|
date: 2026-01-27
|
|
created: 2026-01-27T18:30:00Z
|
|
type: resource
|
|
tags: #{{topic}} #{{category}}
|
|
status: active
|
|
---
|
|
|
|
# {{topic}}
|
|
|
|
## Overview
|
|
{{brief description}}
|
|
|
|
## Key Information
|
|
- Point 1
|
|
- Point 2
|
|
- Point 3
|
|
|
|
## Resources
|
|
- [Link 1](https://...)
|
|
- [Link 2](https://...)
|
|
|
|
## Related Notes
|
|
- [[Note 1]]
|
|
- [[Note 2]]
|
|
```
|
|
|
|
## Storage Locations
|
|
|
|
```
|
|
~/CODEX/
|
|
├── 00-inbox/ # Quick captures
|
|
│ ├── quick-capture.md # Unprocessed notes
|
|
│ ├── web-clips.md # Saved web content
|
|
│ └── learnings.md # New learnings
|
|
├── 01-projects/ # Project-specific knowledge
|
|
├── 02-areas/ # Ongoing responsibilities
|
|
├── 03-resources/ # Reference material
|
|
│ ├── programming/
|
|
│ ├── tools/
|
|
│ ├── documentation/
|
|
│ └── brainstorms/
|
|
└── 04-archive/ # Stale content
|
|
├── projects/
|
|
├── areas/
|
|
└── resources/
|
|
```
|
|
|
|
## Search Patterns
|
|
|
|
Use ripgrep for fast vault-wide searches:
|
|
|
|
```bash
|
|
# Search by topic
|
|
rg "NixOS" ~/CODEX --type md
|
|
|
|
# Search by tag
|
|
rg "#programming" ~/CODEX --type md
|
|
|
|
# Search for links
|
|
rg "\\[\\[" ~/CODEX --type md
|
|
|
|
# Find recent notes
|
|
rg "date: 2026-01-2" ~/CODEX --type md
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
1. **Capture quickly, organize later** - Don't overthink during capture
|
|
2. **Use WikiLinks generously** - Creates network effect
|
|
3. **Tag for retrieval** - Tag by how you'll search, not how you think
|
|
4. **Maintain PARA structure** - Keep notes in appropriate folders
|
|
5. **Archive regularly** - Move inactive content to 04-archive
|
|
6. **Use templates** - Consistent structure for same note types
|
|
7. **Leverage graph view** - Visual connections reveal patterns
|
|
|
|
## Templates
|
|
|
|
### Quick Capture Template
|
|
```markdown
|
|
---
|
|
date: {{date}}
|
|
created: {{timestamp}}
|
|
type: note
|
|
tags: #quick-capture
|
|
---
|
|
|
|
# {{title}}
|
|
|
|
## Notes
|
|
{{content}}
|
|
|
|
## Related
|
|
- [[]]
|
|
```
|
|
|
|
### Learning Template
|
|
```markdown
|
|
---
|
|
date: {{date}}
|
|
created: {{timestamp}}
|
|
type: learning
|
|
tags: #learning #{{topic}}
|
|
---
|
|
|
|
# {{topic}}
|
|
|
|
## What I Learned
|
|
{{key insight}}
|
|
|
|
## Why It Matters
|
|
{{application}}
|
|
|
|
## References
|
|
- [Source](url)
|
|
- [[]]
|
|
```
|
|
|
|
## Integration with Other Skills
|
|
|
|
| From | To knowledge-management | Trigger |
|
|
|------|----------------------|---------|
|
|
| research | Save findings | "Save this research" |
|
|
| task-management | Link to projects/areas | "Note about project X" |
|
|
| brainstorming | Save brainstorm | "Save this brainstorm" |
|
|
| daily-routines | Process inbox | "Weekly review" |
|
|
|
|
## Notes
|
|
|
|
Expand based on actual note-taking patterns. Consider integration with mem0-memory skill for AI-assisted recall.
|