# obsidian-organizer

Files notes into the right Obsidian vault folders and audits structure. It helps when an inbox grows messy and manual sorting breaks internal links.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1800 installs · ★ 92
- Author: Agents365-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Agents365-ai/365-skills/tree/HEAD/plugins/obsidian-organizer/skills/obsidian-organizer/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/obsidian-organizer

## What it 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.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/obsidian-organizer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/obsidian-organizer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/obsidian-organizer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/obsidian-organizer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Agents365-ai/365-skills obsidian-organizer
```

2. **Manually: put the files in place**
- File: `.github/skills/obsidian-organizer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Agents365-ai/365-skills --path plugins/obsidian-organizer/skills/obsidian-organizer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/obsidian-organizer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Agents365-ai/365-skills --skill obsidian-organizer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Agents365-ai/365-skills/tree/HEAD/plugins/obsidian-organizer/skills/obsidian-organizer/SKILL.md

## When to use it
- 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
- 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

## Similar
- [obsidian-cli](https://affpapa.org/en/nevibecode/skills/obsidian-cli.md) — skill · 81000 installs
- [obsidian](https://affpapa.org/en/nevibecode/skills/obsidian.md) — skill · 6400 installs
- [obsidian-markdown](https://affpapa.org/en/nevibecode/skills/agricidaniel-obsidian-markdown.md) — skill · 545 installs
- [obsidian-bases](https://affpapa.org/en/nevibecode/skills/agricidaniel-obsidian-bases.md) — skill · 498 installs
- [obsidian-literature-workflow](https://affpapa.org/en/nevibecode/skills/obsidian-literature-workflow.md) — skill · 408 installs
- [Obsidian Automation](https://affpapa.org/en/nevibecode/skills/obsidian-automation.md) — skill · 4800 installs

From the same set: [agents365-ai/365-skills](https://affpapa.org/en/nevibecode/by/agents365-ai/365-skills.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md