Expert guidance for working with Obsidian vaults including Obsidian Flavored Markdown (OFM) syntax, organization best practices, daily/weekly task workflows, vault maintenance, and automation. This skill should be used when working with Obsidian notes, organizing vault structure, setting up task management workflows, or integrating with Obsidian tooling.
/plugin marketplace add killerapp/mem8-plugin/plugin install mem8@mem8-officialThis skill inherits all available tools. When active, it can use any tool Claude has access to.
assets/templates/CLAUDE.mdassets/templates/daily-note.mdassets/templates/project.mdassets/templates/weekly-review.mdreferences/ofm-syntax.mdreferences/organization-guide.mdreferences/task-workflows.mdreferences/tools-and-automation.mdscripts/vault_health.pyThis skill provides expert guidance for working with Obsidian vaults, enabling effective knowledge management through proper syntax usage, organizational best practices, and workflow automation. It covers Obsidian Flavored Markdown (OFM), modern organization methodologies, task management workflows, and integration with Claude Code.
Use this skill when:
Obsidian extends standard Markdown with wiki-inspired features:
Wikilinks (Internal Linking):
[[Note Name]] - Link to another note[[Note Name|Display Text]] - Custom display text[[Note#Heading]] - Link to specific heading[[Note^block-id]] - Link to specific block^block-id at end of any line to create referenceable blocksEmbeds (Transclusion):
![[Note]] - Embed entire note![[Note#Heading]] - Embed from heading onwards![[Note^block-id]] - Embed specific block![[Image.jpg]] - Embed media filesCallouts:
> [!note] Optional Title
> Content here
Types: note, tip, info, todo, warning, danger, error, bug, example, abstract, success, question, failure, important, quote
Collapsible: [!tip]+ (expanded) or [!tip]- (collapsed)
Tags:
#tag - Basic tag#parent/child/grandchild - Nested hierarchyComments:
%% Hidden comment %% - Obsidian-only, not portableHighlights:
==highlighted text== - Obsidian-specificProperties/Frontmatter:
---
title: Note Title
date: 2025-11-12
tags: [tag1, tag2]
status: active
---
Math (LaTeX):
$E = mc^2$$$equation$$Diagrams (Mermaid):
```mermaid
graph LR
A --> B --> C
```
Dataview Queries (if plugin installed):
```dataview
TABLE rating, date
FROM #books
SORT rating DESC
```
For complete syntax details, refer to references/ofm-syntax.md.
ACE Framework (Recommended):
Atlas/ # Knowledge maps, ideas, reference materials
Calendar/ # Daily notes, periodic notes, time-based entries
Efforts/ # Projects, goals, active work
FINVA System (Workflow-based):
Fleeting/ # Quick rough notes (weekly review)
In Progress/ # Projects needing work
Notes/ # Permanent completed notes
Views/ # MOCs and organizational notes
Archives/ # Old projects
Zettelkasten (Research-focused):
Fleeting/ # Temporary captures
Permanent/ # Atomic evergreen notes
MOCs are index notes that link to related notes:
# Topic Name
## Overview
Brief description
## Subtopic 1
- [[Note 1]]
- [[Note 2]]
## Subtopic 2
- [[Note 3]]
- [[Note 4]]
Create MOCs when:
For detailed organization strategies, refer to references/organization-guide.md.
Daily note template available at assets/templates/daily-note.md
Weekly review template available at assets/templates/weekly-review.md
Project template available at assets/templates/project.md
- [ ] Basic task
- [ ] Task with due date =Å 2025-11-15
- [ ] High priority task ë
- [ ] Recurring task = every week
Use Day Planner plugin with 24-hour format:
## Today's Schedule
- [ ] 07:00 Morning Routine
- [ ] 08:00 Deep Work - Project X
- [ ] 10:00 Team Meeting
For complete workflow details, refer to references/task-workflows.md.
When performing vault health checks:
Find broken links:
[[wikilinks]]Find orphaned notes:
Check frontmatter completeness:
Find duplicate titles:
Identify stubs:
Use scripts/vault_health.py for automated health checks.
When organizing notes:
Analyze content:
Suggest improvements:
Get approval:
When performing batch operations:
Always preview changes first:
Process in batches:
Preserve Obsidian syntax:
Backup reminder:
Always ensure:
Frontmatter is present and complete:
---
title: Note Title
created: YYYY-MM-DD
tags: [relevant, tags]
---
First heading matches title:
# Note Title
Wikilinks are properly formatted:
[[Note Name]] not [Note Name](note-name.md)Appropriate callouts for key info:
> [!important]
> Critical information here
Related notes are linked:
Tags follow convention:
#category/subcategoryFor AI-assisted vault management:
npx -y @smithery/cli install mcp-obsidian --client claudeRecommend users create CLAUDE.md in vault root with:
Example vault context file available at assets/templates/CLAUDE.md
obsidian_read_note - Read content and metadataobsidian_global_search - Search entire vaultobsidian_update_note - Append, prepend, or overwriteobsidian_manage_frontmatter - Get/set YAML metadataobsidian_manage_tags - Add/remove tagsFor complete tooling reference, see references/tools-and-automation.md.
obsidian-metadata CLI for bulk updates, enforce template usageFor comprehensive details on specific topics, refer to:
references/ofm-syntax.md - Complete OFM syntax guidereferences/organization-guide.md - Detailed organization strategiesreferences/task-workflows.md - Complete workflow implementationsreferences/tools-and-automation.md - CLI tools and automation guideTemplates and assets available in assets/templates/.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.