How do I install the Obsidian Organizer skill?

Run npx skillmds@latest add melgarafael/obsidian-organizer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Organizer safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Organizer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Organizer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian Organizer?

melgarafael (@melgarafael) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Organizer by melgarafael — Agent Skill

Name: Obsidian Organizer
Author: melgarafael

Obsidian Organizer

Esta skill deve ser usada quando o usuario diz "organiza meu vault", "ve o que esta bagunçado", "sugere consolidações", "detecta duplicatas", "confere os MOCs", ou invoca `/obsidian-master-kit:organize`. Roda clustering HDBSCAN sobre os embeddings do vault, detecta pares proximos (cos >= DUPLICATE_MIN_COS) que sao candidatos a duplicata conceitual, encontra clusters grandes sem MOC proprio, flagga notas com `area` no frontmatter divergente da pasta onde moram, e propoe tudo em `migration_plan` pra aprovacao humana. NUNCA move ou apaga arquivos sem verdict explicito.

melgarafael Updated Sep 17, 2026

File contents

obsidian-organizer

Organizador semantico do vault. Varre tudo com IA, detecta bagunca, propoe consolidacoes. 100% local, zero side-effects sem aprovacao.

Quando usar

Usuario diz "organiza meu vault", "limpa duplicatas", "expande MOCs", "o que ta bagunçado?".
Usuario invoca /obsidian-master-kit:organize.
Apos um scan completo (obsidian-master scan) — organizer consome dados de notes + vec_notes/notes_embedding_blob.

Quando nao usar

Em vault vazio ou com < 10 notas (HDBSCAN nao tem material).
Sem ter rodado scan primeiro.
Pra ACAO destrutiva — organizer SO propoe; obsidian-migrate apply executa os moves/merges aprovados.

Fluxo canonico

Passo 1: Detecte o vault

Walk ancestrais do cwd procurando .obsidian-master/marker.json. Se nao achar, aborte com --vault PATH.

Passo 2: Garanta scan recente

Se notes+vec estao desatualizados, peca ao usuario pra rodar obsidian-master scan primeiro.

Passo 3: Escolha o sub-comando

Intencao do usuario	Sub-comando
"Agrupa as notas parecidas" / "Cluster semantico"	`cluster`
"Acha duplicatas de conceito"	`duplicates`
"Quais clusters faltam MOC?"	`moc-audit`
"Area do frontmatter bate com a pasta?"	`area-mismatch`
"Propoe tudo em lotes pra eu aprovar"	`propose`
"Me da o relatorio visual"	`report`

Passo 4: Invoque o script

python3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-organizer/scripts/organizer.py \
  <sub-comando> [--vault PATH] [--dry-run] [opcoes]

Passo 5: Apresente em pt-br humano

O script emite JSON estavel. Traduza pra markdown com reasoning embaixo:

3 candidatos de duplicata:

1. [[Cabala]] ↔ [[Qabalah]]
   Cosine: 0.78, ambas na area Pesquisas. Verdict pendente.

2. [[Hermetismo - Overview]] ↔ [[Hermetismo Antigo]]
   Cosine: 0.72, ambas na area Pesquisas.

...

Passo 6: Aplique os verdicts aprovados

duplicates --interactive pede verdict (merge | keep_both | not_duplicate). propose gera batches em migration_plan. Execucao real e pelo obsidian-migrate apply.

Garantias duras

Zero escrita silenciosa: --dry-run e default em propose e moc-audit.
Verdicts humanos: duplicate_candidates.verdict so muda via aprovacao explicita.
Preserva conteudo: merge final concatena os dois, renomeia .merged-TIMESTAMP. Nada e perdido.
Integra com migrate: organizer propõe, migrate aplica — separacao clara.

CLI: referencia rapida

organizer cluster [--latest] [--ai-label] — HDBSCAN runner
organizer duplicates [--min-cos X] [--interactive] — detecta + verdict
organizer moc-audit [--create-suggestions] — clusters ≥ 10 sem MOC
organizer area-mismatch [--fix] — area frontmatter ≠ pasta
organizer propose [--dry-run] — agrega tudo em migration_plan
organizer report — relatorio visual consolidado

---name: obsidian-organizerdescription: Esta skill deve ser usada quando o usuario diz "organiza meu vault", "ve o que esta bagunçado", "sugere consolidações", "detecta duplicatas", "confere os MOCs", ou invoca `/obsidian-master-kit:organize`. Roda clustering HDBSCAN sobre os embeddings do vault, detecta pares proximos (cos >= DUPLICATE_MIN_COS) que sao candidatos a duplicata conceitual, encontra clusters grandes sem MOC proprio, flagga notas com `area` no frontmatter divergente da pasta onde moram, e propoe tudo em `migration_plan` pra aprovacao humana. NUNCA move ou apaga arquivos sem verdict explicito.---# obsidian-organizerOrganizador semantico do vault. Varre tudo com IA, detecta bagunca, propoe consolidacoes. 100% local, zero side-effects sem aprovacao.## Quando usar- Usuario diz "organiza meu vault", "limpa duplicatas", "expande MOCs", "o que ta bagunçado?".- Usuario invoca `/obsidian-master-kit:organize`.- Apos um scan completo (`obsidian-master scan`) — organizer consome dados de `notes` + `vec_notes`/`notes_embedding_blob`.## Quando **nao** usar- Em vault vazio ou com < 10 notas (HDBSCAN nao tem material).- Sem ter rodado scan primeiro.- Pra ACAO destrutiva — organizer SO propoe; `obsidian-migrate apply` executa os moves/merges aprovados.## Fluxo canonico### Passo 1: Detecte o vaultWalk ancestrais do cwd procurando `.obsidian-master/marker.json`. Senao achar, aborte com `--vault PATH`.### Passo 2: Garanta scan recenteSe notes+vec estao desatualizados, peca ao usuario pra rodar `obsidian-master scan` primeiro.### Passo 3: Escolha o sub-comando| Intencao do usuario | Sub-comando ||---|---|| "Agrupa as notas parecidas" / "Cluster semantico" | `cluster` || "Acha duplicatas de conceito" | `duplicates` || "Quais clusters faltam MOC?" | `moc-audit` || "Area do frontmatter bate com a pasta?" | `area-mismatch` || "Propoe tudo em lotes pra eu aprovar" | `propose` || "Me da o relatorio visual" | `report` |### Passo 4: Invoque o script```bashpython3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-organizer/scripts/organizer.py \ <sub-comando> [--vault PATH] [--dry-run] [opcoes]```### Passo 5: Apresente em pt-br humanoO script emite JSON estavel. Traduza pra markdown com reasoning embaixo:```3 candidatos de duplicata:1. [[Cabala]] ↔ [[Qabalah]] Cosine: 0.78, ambas na area Pesquisas. Verdict pendente.2. [[Hermetismo - Overview]] ↔ [[Hermetismo Antigo]] Cosine: 0.72, ambas na area Pesquisas....```### Passo 6: Aplique os verdicts aprovados`duplicates --interactive` pede verdict (`merge | keep_both | not_duplicate`). `propose` gera batches em `migration_plan`. Execucao real e pelo `obsidian-migrate apply`.## Garantias duras1. **Zero escrita silenciosa**: `--dry-run` e default em `propose` e `moc-audit`.2. **Verdicts humanos**: `duplicate_candidates.verdict` so muda via aprovacao explicita.3. **Preserva conteudo**: merge final concatena os dois, renomeia `.merged-TIMESTAMP`. Nada e perdido.4. **Integra com migrate**: organizer propõe, migrate aplica — separacao clara.## CLI: referencia rapida- `organizer cluster [--latest] [--ai-label]` — HDBSCAN runner- `organizer duplicates [--min-cos X] [--interactive]` — detecta + verdict- `organizer moc-audit [--create-suggestions]` — clusters ≥ 10 sem MOC- `organizer area-mismatch [--fix]` — area frontmatter ≠ pasta- `organizer propose [--dry-run]` — agrega tudo em migration_plan- `organizer report` — relatorio visual consolidado

Frequently asked questions