CommunityEscrita e Ediçãogithub.com

steipete/obsidian

Baú Obsidian: pesquisar/ler/escrever notas, backlinks, Bases, Canvas.

O que é obsidian?

Esta skill fornece acesso completo a um baú (vault) local do Obsidian, permitindo que agentes de IA pesquisem, leiam e escrevam notas Markdown, gerenciem backlinks, interajam com arquivos de Base e Canvas, e controlem plugins. Ela utiliza a CLI oficial do Obsidian para operações sensíveis ao contexto do baú e, quando apropriado, recorre a leituras diretas do sistema de arquivos para obter bytes exatos. Suporta fluxos de trabalho de leitura (como busca, contexto, contornos) e escrita (criação, anexação, movimentação), com ênfase em segurança — evitando reescritas em massa, edição de configurações do .obsidian sem permissão e exclusões não solicitadas. A skill resolve automaticamente o baú a partir do diretório de trabalho (cwd) e lista múltiplos baús com obsidian vaults, sendo compatível com Claude Code, Cursor e Codex.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/obsidian

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que obsidian faz?

Use isto para trabalhar com um baú local do Obsidian. Um baú Obsidian é uma pasta normal de arquivos Markdown mais a configuração .obsidian/.

Fontes

  • Configuração do app: ~/Library/Application Support/obsidian/obsidian.json
  • Nome padrão do baú: obsidian
  • Caminho local usual do baú: ~/obsidian
  • CLI oficial: obsidian
  • Os comandos do baú resolvem o baú a partir do diretório atual (cwd); execute-os de ~/obsidian.

Primeiras Verificações

command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:

Comandos globais como version e vaults funcionam fora de um baú. Comandos de conteúdo do baú podem imprimir Vault not found. fora de ~/obsidian. Use obsidian commands, não obsidian help, para descobrir comandos da CLI.

Se o obsidian disser que a CLI está desabilitada:

  1. Prefira pedir ao usuário para ativar Configurações -> Geral -> Avançado -> Interface de linha de comando.
  2. Se você já confirmou a estrutura do arquivo de configuração do app, ~/Library/Application Support/obsidian/obsidian.json usa "cli": true.
  3. Reinicie o Obsidian após alterar a configuração da CLI a nível de app.

Fluxo de Leitura

Prefira a CLI oficial para consultas com conhecimento do Obsidian:

cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Pasta/Nota.md"
obsidian file path="Pasta/Nota.md"
obsidian outline path="Pasta/Nota.md" format=json
obsidian backlinks path="Pasta/Nota.md" format=json
obsidian links path="Pasta/Nota.md"
obsidian properties path="Pasta/Nota.md" format=json

Use leituras diretas do sistema de arquivos quando você já souber o caminho e precisar de bytes exatos:

sed -n '1,220p' "$HOME/obsidian/Pasta/Nota.md"
rg -n "termo" "$HOME/obsidian"

Informe qual fonte você usou quando o frescor ou a escolha do baú forem relevantes.

Fluxo de Escrita

Escolha o caminho de escrita mais restrito:

  • Nova nota: obsidian create path="Pasta/Nota.md" content="...".
  • Anexar/preceder notas diárias: obsidian daily:append content="...".
  • Edições simples de notas: use apply_patch no arquivo Markdown.
  • Renomear/mover notas: prefira obsidian move path="Antiga.md" to="Pasta/Nova.md" para que os links possam ser atualizados.
  • Abrir a interface após uma escrita: adicione open apenas quando útil ou solicitado.

Comandos comuns:

cd ~/obsidian
obsidian create path="Notas/Nova.md" content="# Nova\n\nCorpo"
obsidian append path="Notas/Nova.md" content="Mais texto"
obsidian move path="Notas/Nova.md" to="Arquivo/Nova.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Item de acompanhamento"

Para conteúdo de múltiplas linhas, prefira editar o arquivo .md com apply_patch assim que o caminho for conhecido. Evite citações frágeis em shell para texto longo.

Bases, Canvas, Plugins

Use a descoberta da CLI primeiro:

cd ~/obsidian
obsidian bases
obsidian base:views path="Projetos.base"
obsidian base:query path="Projetos.base" view="Ativo" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:

Para arquivos .canvas, .base e .json, leia/edite como dados estruturados quando possível. Mantenha a formatação estável e valide o JSON após edições.

Segurança

  • Não reescreva o baú em massa. Use caminhos específicos e revise diferenças.
  • Não edite .obsidian/ a menos que o usuário peça ou a tarefa seja explicitamente de configuração/plugins.
  • Não exclua notas a menos que explicitamente solicitado; prefira a lixeira em vez de exclusão permanente.
  • Não crie notas ocultas em pastas com ponto (dot-folder) através do caminho CLI/URI do Obsidian.
  • Preserve frontmatter e wikilinks a menos que a tarefa seja refatorá-los.
  • Se houver múltiplos baús, não adivinhe; use obsidian vaults e obsidian.json.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas