Skills Obsidian para Claude e Codex: notas, Bases, Canvas e CLI

As skills Obsidian para agentes dão a um agente de programação orientações sobre os formatos e as ferramentas de um cofre do Obsidian. O repositório obsidian-skills de Steph Ango inclui skills para notas Markdown, Bases, JSON Canvas, Obsidian CLI e extração de conteúdo web. Instale a que corresponde ao trabalho que pretende que o agente faça e depois confira os ficheiros resultantes no seu cofre.

São instruções para um agente. Instalar uma skill não instala o Obsidian, não liga um cofre privado nem concede acesso às suas notas. Decida que cofre ou pasta o agente pode usar antes de lhe pedir alterações.

Escolha uma skill em função do resultado pretendido

Comece com Markdown se pretende sobretudo melhorar as notas. Adicione Bases quando tiver propriedades que sustentem uma vista útil. Adicione Canvas quando as relações ou a sequência forem mais relevantes do que uma tabela. Instalar tudo de uma vez pode dificultar a identificação da funcionalidade que produziu um resultado.

Instale a skill do autor que foi revista

No projeto em que o agente trabalha, execute:

npx usethrive add obsidian-markdown --agent claude
npx usethrive add obsidian-bases --agent claude

O instalador copia cada pasta completa do autor na revisão fixada. Para Codex, use --agent codex; use --agent both quando esse projeto precisar de ambas as localizações. As pastas de skills existentes não são alteradas. Examine uma instalação anterior antes de decidir se a deve substituir.

O catálogo da Thrive remete para o repositório do autor. Mantenha essa distinção clara: são as skills originais de Steph Ango, incluídas na Thrive com a respetiva proveniência. A pasta da skill contém as orientações reutilizáveis, enquanto o cofre contém as notas que cria.

Crie uma nota de fonte antes de alterar um cofre

Use um pequeno cofre descartável ou uma pasta de exemplo com cópia de segurança para a primeira tarefa. Peça ao agente que crie uma nota nova, mostre o resultado e identifique as ligações que precisam de um destino existente. Evite começar por renomear notas em massa ou por reescrever todas as notas.

Layout ilustrativo de um cofre com propriedades de notas, wikilinks, uma caixa de destaque e uma vista ao estilo do Bases. Abra a ilustração no tamanho original.

Eis uma nota de projeto fictícia que pode adaptar:

---
title: Newsletter migration
tags:
  - project
  - content
status: research
---

# Newsletter migration

## Decision to make
Choose how the archive maps into the new CMS.

## Related notes
- [[Content inventory]]
- [[Migration acceptance criteria]]

> [!warning]
> Check which source entries are drafts before importing them.

Os nomes das propriedades são exemplos, não um requisito para todos os cofres. Reutilize o vocabulário e os tipos de propriedades existentes. Se o cofre já usa stage em vez de status, adapte o exemplo a essa convenção em vez de introduzir um campo concorrente.

Abra a nota na vista de leitura. Verifique se a caixa de destaque é apresentada, se as etiquetas têm a forma pretendida e se os nomes das notas ligadas estão corretos. Um wikilink sem destino pode ser intencional quando pretende criar esse destino, mas não deve surgir por acidente.

Use Bases quando a estrutura assenta nas propriedades

Uma Base é útil quando pretende ver notas que partilham propriedades: projetos ativos, notas de leitura ou registos de reuniões, por exemplo. Antes de pedir ao agente que crie a vista, liste as propriedades existentes e os valores que contêm. Um filtro não consegue distinguir de forma fiável o trabalho concluído se metade das notas usa done e a outra metade usa complete sem um mapeamento.

Peça uma vista com uma finalidade específica, como notas de projeto cujo estado é research. Especifique as colunas necessárias e o comportamento para datas em falta. Teste-a com uma nota que corresponda ao filtro, uma que não corresponda e uma que não tenha uma das propriedades. Isto verifica a lógica, para além do aspeto da tabela.

Mantenha as notas de origem como registo da informação subjacente. Uma vista bem apresentada não corrige metadados inconsistentes. Se for necessária normalização, proponha o mapeamento e reveja uma pequena amostra antes de o aplicar de forma alargada.

Use Canvas para relações e sequências

A skill JSON Canvas ajuda um agente a criar nós e arestas usando .canvas como formato de ficheiro. Para uma migração, pode ligar uma nota de inventário a uma decisão de mapeamento e depois ligar essa decisão a uma lista de verificação de validação. Esse grafo explica que evidências levaram a uma ação.

Peça um canvas com um âmbito limitado antes de adicionar muitos nós. Exija identificadores únicos, referências válidas entre arestas e nós, rótulos legíveis e espaço suficiente para evitar sobreposições. Valide o JSON, depois abra-o no Obsidian e examine a disposição efetiva. A validação da sintaxe não revela se o rótulo de um nó é demasiado pequeno ou se o diagrama está sobrecarregado.

Os nós de ficheiro devem referir caminhos reais do cofre. Se o agente desconhecer o caminho, peça-lhe que liste a referência em falta em vez de a inventar. Mantenha os URLs de fontes externas separados das ligações internas entre notas para que os leitores consigam distinguir que evidências pertencem ao cofre.

Verifique os pré-requisitos da CLI

A skill Obsidian CLI pressupõe a interface de linha de comandos da aplicação de computador. A documentação da CLI do Obsidian explica a instalação e a ativação. Consulte aí os requisitos atuais da aplicação e do instalador e execute obsidian help para confirmar os comandos disponíveis no seu computador.

Após a configuração, estes exemplos orientados para a leitura podem ajudar a verificar a ligação:

obsidian vault="Research" search query="migration"
obsidian vault="Research" read path="Projects/Newsletter migration.md"

Substitua o cofre e o caminho do exemplo por outros que autorizou o agente a ler. Selecionar explicitamente um cofre é útil quando tem vários abertos. Escrever, renomear e eliminar notas exige uma tarefa clara e uma revisão dos caminhos afetados; o acesso bem-sucedido à CLI não estabelece autorização para todas as operações.

Mantenha a investigação rastreável

Ao adicionar uma referência web, preserve o título, o URL, a data de consulta e as passagens relevantes para a sua pergunta. O Defuddle pode ajudar a extrair uma página pública para Markdown legível, mas a ferramenta tem de ser instalada separadamente e o resultado continua a precisar de ser conferido com a fonte.

Para notas sobre vídeos, use a skill de preparação de transcrições do YouTube para preservar as legendas e as marcas temporais antes de criar a nota. Não apresente um resumo baseado apenas na transcrição como uma análise das demonstrações visuais do vídeo.

Fontes

• Repositório de skills Obsidian na revisão fixada

• Documentação da CLI do Obsidian

• Documentação de propriedades do Obsidian

• Especificação JSON Canvas