Obsidian Init

obsidian-init

Scaffolda um vault Obsidian completo seguindo o padrao obsidian-master-kit: 4 areas, CLAUDE.md doutrina, _INDEX.md vivo, MOCs por area, templates por tipo de nota.

Quando usar

• Usuario diz: "quero criar meu segundo cerebro", "inicia meu vault Obsidian",

"scaffolda um Obsidian pra mim", "cria a estrutura de pastas do Obsidian"

• Usuario invoca /obsidian-master-kit:init (slash command)
• Usuario aponta para uma pasta vazia e quer transformar em vault

Quando nao usar

• Usuario ja tem um vault funcionando e so quer adicionar notas (use outras skills)
• Usuario quer editar o CLAUDE.md do vault (ele mesmo edita, nao a IA)
• Usuario quer sincronizar um vault existente (use obsidian-librarian)

Como usar — fluxo canonico

Passo 1: Determine o diretorio-alvo

Pergunte onde scaffoldar. Candidatos comuns:

• Pasta atual (pwd) — se o usuario ja fez cd para la
• ~/Documents/ — escolha dele
• Um --path explicito que ele pode ter passado

Sempre confirme antes de prosseguir. Nao scaffolda em ~ ou em pasta com codigo.

Passo 2: Cheque estado do alvo

Se a pasta tem arquivos:

• Tem .obsidian-master/marker.json? Ja e um vault-master — aborte e sugira

/obsidian-master-kit:sync em vez disso.

• Tem outros arquivos? Confirme com o usuario antes de prosseguir. O script preserva

arquivos existentes (so preenche buracos), mas avise.

Passo 3: Conduza a entrevista

Siga o roteiro em references/interview-script.md. Sao 7 perguntas curtas em pt-br. Se o usuario passou --profile , leia o arquivo e pule perguntas ja cobertas.

Passo 4: Invoque o script

Use o script scripts/scaffold_vault.py passando todas as respostas via flags. Exemplo:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-init/scripts/scaffold_vault.py \
  --path "/Users/nome/Documents/MeuVault" \
  --owner-name "Nome Sobrenome" \
  --owner-profession "Desenvolvedor de software" \
  --owner-areas "Backend; DevOps; Mentoria" \
  --owner-projects "Projeto A; Projeto B" \
  --owner-lang "pt-br" \
  --owner-timezone "America/Sao_Paulo" \
  --owner-tone "casual" \
  --vault-name "Meu Segundo Cerebro"

O script:

1. Copia a arvore de assets/vault-template/ para o alvo.
2. Interpola placeholders ({{OWNER_NAME}}, {{DATE_TODAY}}, etc.).
3. Gera stubs por projeto em 01 - Profissional/Projetos/.
4. Gera stubs por area em 01 - Profissional/Areas/.
5. Escreve .obsidian-master/marker.json com a versao do kit.
6. Imprime relatorio: arquivos criados, projetos stubados, proximos passos.

Nunca sobrescreve arquivos existentes. Use --dry-run antes se incerto.

Passo 5: Reporte proximos passos

Depois que o script termina:

• Diga ao usuario para abrir a pasta no Obsidian (File > Open Vault).
• Sugira revisar 00 - Pessoal/Perfil.md e ajustar a bio.
• Sugira criar a primeira entrada de diario usando o template.
• Mencione que daqui pra frente o bibliotecario cuida do _INDEX.md sozinho.

Flags do script — referencia rapida

| Flag | Obrigatoria? | Default | Descricao | |---|---|---|---| | --path | nao | pwd | Onde scaffoldar o vault | | --owner-name | sim | — | Nome do dono | | --owner-profession | sim | — | Funcao / profissao | | --owner-areas | nao | "" | Areas separadas por ; | | --owner-projects | nao | "" | Projetos separados por ; | | --owner-lang | nao | pt-br | Idioma do journaling | | --owner-timezone | nao | America/Sao_Paulo | Fuso | | --owner-tone | nao | casual | casual ou formal | | --vault-name | nao | basename do path | Nome humano do vault | | --profile | nao | — | YAML/JSON com todas as respostas | | --dry-run | nao | false | Imprime plano, nao escreve | | --force | nao | false | Permite escrever em pasta ja com conteudo |

Guardrails

• Nunca rode o script sem confirmar path com o usuario.
• Nunca rode em $HOME, /, /Users, /tmp (sem --force) ou em pasta com .git

que nao seja um vault-master.

• Nunca sobrescreve arquivos existentes (o script ja protege, mas confirme antes).
• Se a pasta tem .obsidian-master/marker.json, nao rode init — use o librarian.

O que este skill NAO faz

• Nao instala o Obsidian (app). Isso e manual.
• Nao configura plugins do Obsidian (Dataview, Templater, etc.). Ver roadmap.
• Nao sincroniza com nuvem. Ver FAQ do README principal.
• Nao edita o CLAUDE.md do vault depois de criado — isso e territorio humano.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: melgarafael
• Source: melgarafael/obsidian-master-kit
• License: MIT

Install and usage instructions live in the source repository linked above.