AGENTS/skills/knowledge-management/SKILL.md

name, description, compatibility

name	description	compatibility
knowledge-management	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.	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

---
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

---
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:

# 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

---
date: {{date}}
created: {{timestamp}}
type: note
tags: #quick-capture
---

# {{title}}

## Notes
{{content}}

## Related
- [[]]

Learning Template

---
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.