obsidian-organizer — Claude Code skill: what it does, how to install
Files notes into the right Obsidian vault folders and audits structure. It helps when an inbox grows messy and manual sorting breaks internal links.
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a claude-codeWhat obsidian-organizer does
The skill manages vault organization using the obsidian CLI connected directly to an active desktop session. Instead of traversing hundreds of directories repeatedly, it reads a single source of truth: 00_Index/Folder_Map.md. This map lives inside the vault as plain markdown bullets. The assistant reads the file once, picks the matching path, and executes the change.
Safety matters when moving files. The skill uses obsidian move and obsidian rename instead of raw shell tools. Shell utilities like mv leave dead wikilinks behind. Obsidian's native calls let the app rewrite backlinks automatically across the entire vault.
The desktop app must be open during operation, or connection calls immediately fail. When you approve an entirely new category, the agent appends it to the map note so future runs remember it.
What it helps with
- route incoming notes to matching vault folders
- find orphan notes that lack incoming links
- detect dead-end notes with no outgoing links
- maintain a single markdown taxonomy map inside the vault
Example prompts for the agent
- File the note Inbox/Draft.md into the best matching folder in vault MyVault
- Check the Research folder for orphan notes and summarize dead ends
- Add a new category for machine learning notes into Folder_Map.md
How to install obsidian-organizer
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a claude-code2Manually: put the files in place
~/.claude/skills/obsidian-organizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/obsidian-organizer/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a codex2Manually: put the files in place
.agents/skills/obsidian-organizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a cursor2Manually: put the files in place
.cursor/skills/obsidian-organizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Agents365-ai/365-skills obsidian-organizer2Manually: put the files in place
.github/skills/obsidian-organizer/SKILL.md1Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/obsidian-organizer/skills/obsidian-organizerManually: put the files in place
.devin/skills/obsidian-organizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about obsidian-organizer
How to install obsidian-organizer in Claude Code?
Run npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a claude-code in your terminal. The skill configures itself for Claude Code immediately.
What does obsidian-organizer do?
It categorizes notes into correct folders using a central markdown map and runs vault audits. It can inspect orphans, detect dead-end files, and rename notes safely.
Why does the Obsidian desktop app need to run?
The underlying obsidian CLI communicates directly with the live desktop process. If Obsidian is closed, CLI requests fail with connection errors.
