Le skill Obsidian per agenti forniscono a un agente di programmazione indicazioni sui formati e sugli strumenti di un vault Obsidian. Il repository obsidian-skills di Steph Ango include skill per note Markdown, Bases, JSON Canvas, Obsidian CLI ed estrazione di contenuti web. Installa quella adatta al lavoro che vuoi assegnare all'agente, poi controlla i file prodotti nel vault.
Si tratta di istruzioni per un agente. Installare una skill non installa Obsidian, non collega un vault privato e non concede l'accesso alle note. Decidi quale vault o cartella può usare l'agente prima di chiedergli modifiche.
Scegli la skill in base al risultato che ti serve
Attività | Skill Thrive | Risultato o dipendenza |
|---|---|---|
Scrivere note collegate con proprietà e callout |
| |
Organizzare le note in viste filtrate |
| |
Disporre note e idee nello spazio |
| |
Cercare o gestire un vault aperto dal terminale | Obsidian CLI abilitata | |
Estrarre testo leggibile da una pagina web pubblica | CLI di Defuddle disponibile separatamente |
Parti da Markdown se vuoi soprattutto migliorare le note. Aggiungi Bases quando le proprietà consentono di creare una vista utile. Aggiungi Canvas quando le relazioni o la sequenza contano più di una tabella. Installare tutto insieme può rendere più difficile capire quale funzionalità ha prodotto un risultato.
Installa la skill verificata dell'autore
Dal progetto in cui lavora l'agente, esegui:
npx usethrive add obsidian-markdown --agent claude
npx usethrive add obsidian-bases --agent claudeL'installer copia per intero ciascuna cartella dell'autore alla revisione indicata. Per Codex, usa --agent codex; usa --agent both quando il progetto richiede entrambe le posizioni. Le cartelle delle skill esistenti restano intatte. Esamina un'installazione precedente prima di decidere se sostituirla.
Il catalogo Thrive rimanda al repository dell'autore. Mantieni chiara questa distinzione: sono le skill originali di Steph Ango, elencate da Thrive con la loro provenienza. La cartella della skill contiene le istruzioni riutilizzabili, mentre il vault contiene le note che crei.
Crea una nota sulla fonte prima di modificare un vault
Per la prima attività, usa un piccolo vault temporaneo o una cartella di esempio di cui hai una copia di sicurezza. Chiedi all'agente di creare una nuova nota, mostrare il risultato e indicare i collegamenti che richiedono una destinazione esistente. Evita di iniziare con una rinomina in blocco o la riscrittura di tutte le note.
Layout illustrativo di un vault fittizio con proprietà delle note, wikilink, un callout e una vista simile a Bases. Apri l'illustrazione a dimensione intera.
Ecco una nota di progetto fittizia che puoi adattare:
---
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.I nomi delle proprietà sono esempi, non requisiti per tutti i vault. Riusa il lessico e i tipi di proprietà esistenti. Se il vault usa già stage invece di status, adatta l'esempio a quella convenzione anziché introdurre un campo concorrente.
Apri la nota nella vista di lettura. Controlla che il callout sia visualizzato, che i tag abbiano la forma prevista e che i nomi delle note collegate siano corretti. Un wikilink senza destinazione può essere intenzionale se prevedi di creare la nota corrispondente, ma non dovrebbe comparire per errore.
Usa Bases quando la struttura dipende dalle proprietà
Una Base è utile per visualizzare note che condividono proprietà: per esempio, progetti attivi, note di lettura o verbali di riunione. Prima di chiedere all'agente di costruire la vista, elenca le proprietà esistenti e i valori che contengono. Un filtro non può distinguere in modo affidabile il lavoro completato se metà delle note usa done e l'altra metà usa complete senza una mappatura.
Chiedi una sola vista con uno scopo preciso, per esempio le note di progetto il cui stato è research. Specifica le colonne necessarie e il comportamento in caso di date mancanti. Provala con una nota che soddisfa il filtro, una che non lo soddisfa e una priva di una proprietà. In questo modo verifichi la logica, oltre all'aspetto della tabella.
Conserva le note originali come registro delle informazioni su cui si basa la vista. Una vista ben presentata non corregge metadati incoerenti. Se serve una normalizzazione, proponi la mappatura ed esamina un piccolo campione prima di applicarla su larga scala.
Usa Canvas per relazioni e sequenze
La skill JSON Canvas aiuta un agente a creare nodi e archi in un file .canvas. Per una migrazione, potresti collegare una nota di inventario a una decisione di mappatura, poi quella decisione a una checklist di verifica. Il grafo spiega quali prove hanno portato a un'azione.
Chiedi un canvas limitato prima di aggiungere molti nodi. Richiedi ID univoci, riferimenti validi tra archi e nodi, etichette leggibili e spazio sufficiente a evitare sovrapposizioni. Verifica il JSON, poi aprilo in Obsidian e controlla la disposizione effettiva. La verifica della sintassi non può dirti se l'etichetta di un nodo è troppo piccola o se il diagramma è affollato.
I nodi file devono rimandare a percorsi reali nel vault. Se l'agente non conosce il percorso, chiedigli di indicare il riferimento mancante anziché inventarlo. Tieni gli URL delle fonti esterne separati dai collegamenti interni alle note, così chi legge può riconoscere quali prove appartengono al vault.
Verifica i prerequisiti della CLI
La skill Obsidian CLI richiede l'interfaccia a riga di comando dell'applicazione desktop. La documentazione di Obsidian CLI spiega come installarla e abilitarla. Consulta lì i requisiti attuali dell'applicazione e dell'installer ed esegui obsidian help per verificare i comandi disponibili sul tuo computer.
Dopo la configurazione, questi esempi di lettura possono aiutarti a verificare il collegamento:
obsidian vault="Research" search query="migration"
obsidian vault="Research" read path="Projects/Newsletter migration.md"Sostituisci vault e percorso di esempio con quelli che hai autorizzato l'agente a leggere. Selezionare esplicitamente un vault è utile quando ne hai diversi aperti. Scrivere, rinominare ed eliminare note richiede un compito chiaro e una verifica dei percorsi interessati; riuscire ad accedere tramite CLI non autorizza ogni operazione.
Mantieni tracciabili le ricerche
Quando aggiungi una fonte web, conserva titolo, URL, data di consultazione e passaggi pertinenti alla domanda. Defuddle può aiutarti a estrarre una pagina pubblica in Markdown leggibile, ma lo strumento va installato separatamente e il risultato va comunque verificato sulla fonte.
Per le note sui video, usa la skill per preparare trascrizioni YouTube per conservare sottotitoli e riferimenti temporali prima di creare la nota. Non presentare un riassunto basato solo sulla trascrizione come un esame delle dimostrazioni visive del video.
