my-skills/skills/obsidian-skills.md

obsidian-skills

• Autore: kepano (Steph Ango, CEO di Obsidian)
• Repository: kepano/obsidian-skills (licenza MIT)
• Sorgenti: cartella skills/, un SKILL.md per skill
• Pagina su skills.sh: kepano/obsidian-skills
• Diffusione (ottobre 2026): circa 396.200 installazioni complessive tramite npx skills; il repository ha circa 49.600 stelle e 3.500 fork su GitHub
• Controlli di sicurezza su skills.sh: obsidian-markdown supera Gen Agent Trust Hub, Socket e Snyk; obsidian-cli supera Socket e Snyk, mentre Gen Agent Trust Hub segnala un avviso (la pagina non spiega il motivo). Le altre skill non le ho controllate.

Non è una sola skill ma una raccolta di sei skill. Con lo stesso nome esistono altri repository non ufficiali (per esempio tpitsunov/obsidian-skills e adriangrantdotorg/Obsidian-Skills): questa scheda riguarda solo quello di kepano.

A cosa serve

Insegna all'agente a lavorare con Obsidian: scrivere note nel suo dialetto di Markdown, creare viste a database (Bases) e lavagne (Canvas), e comandare l'app dal terminale. In più aggiunge due strumenti utili per portare contenuti nelle note: estrarre il testo pulito dalle pagine web e generare note da modelli e dati.

Cosa fa

Le sei skill

Skill	Installazioni	Cosa fa
obsidian-markdown	~90.500	scrive e modifica note nel Markdown di Obsidian
obsidian-cli	~79.000	comanda Obsidian dal terminale, anche per sviluppare plugin e temi
obsidian-bases	~77.900	crea e modifica file .base (viste a database sulle note)
json-canvas	~72.700	crea e modifica file .canvas (lavagne con nodi e collegamenti)
defuddle	~72.600	estrae Markdown pulito dalle pagine web
knap	~3.700	genera documenti Markdown da modelli e dati JSON o CSV

obsidian-markdown

Si attiva quando l'agente scrive o modifica note di Obsidian. Copre la sintassi propria di Obsidian, dando per scontato il Markdown standard:

Elemento	Esempio
Proprietà (frontmatter YAML)	title, date, tags, aliases in testa alla nota
Wikilink	[[Nome nota|Testo visibile]]
Riferimenti a blocchi	testo ^id-blocco, poi [[Nome nota#^id-blocco]]
Incorporamenti	![[Nome nota#Titolo]], ![[immagine.png|300]]
Callout	> [!warning] Titolo
Tag gerarchici	#progetto/attivo
Evidenziazione	==testo==
Formule LaTeX	$e^{i\pi} + 1 = 0$
Diagrammi Mermaid	blocco ```mermaid
Commenti nascosti	%%testo%%
Note a piè di pagina	testo[^1]

Regola principale: wikilink per le note del vault, perché Obsidian li aggiorna quando rinomini una nota; link Markdown normali solo per gli URL esterni. Il flusso previsto è: proprietà, contenuto, collegamenti, incorporamenti, callout, e infine controllo nella vista di lettura di Obsidian.

obsidian-cli

Usa la riga di comando ufficiale di Obsidian per leggere, creare e cercare note e gestire attività, proprietà e tag.

obsidian read file="Nota"                          # legge una nota
obsidian create name="Nuova nota" content="# Ciao"  # crea una nota
obsidian append file="Nota" content="Nuova riga"   # aggiunge in fondo
obsidian search query="termine" limit=10           # cerca nel vault
obsidian daily:append content="- [ ] Attività"     # aggiunge alla nota del giorno
obsidian property:set name="status" value="done"   # imposta una proprietà
obsidian tasks daily todo                          # elenca le attività

• Destinazione: file= cerca la nota per nome, come un wikilink; path= usa il percorso esatto dalla radice del vault; vault= sceglie il vault. Senza indicazioni lavora sull'ultimo vault usato.
• Opzioni utili: silent non apre il file, total conta i risultati, --copy copia l'output negli appunti.
• Sviluppo di plugin: plugin:reload id=<plugin> ricarica il plugin; dev:errors e dev:console mostrano errori e log; dev:screenshot cattura lo schermo; dev:dom e dev:css ispezionano l'interfaccia; eval code=<js> esegue JavaScript dentro l'app.

Requisiti: Obsidian 1.12 o successivo (consigliato 1.12.7+), con l'opzione Settings → General → Command line interface attiva. Funziona su Windows, macOS e Linux. L'app deve essere aperta; se non lo è, il primo comando la avvia.

obsidian-bases

Crea file .base: file YAML che trasformano un insieme di note in una vista simile a un database.

• Filtri: condizioni (uguale, maggiore, tag, cartella) combinate con and, or, not.
• Formule: proprietà calcolate, per esempio 'if(done, "✅", "⏳")'.
• Viste: tabella, schede, elenco e mappa (la mappa richiede il plugin Maps).
• Riepiloghi: somma, media, minimo, massimo, mediana per proprietà.

filters:
  and:
    - file.hasTag("task")
    - 'status != "done"'
formulas:
  days_left: 'if(due, (date(due) - today()).days, "")'
views:
  - type: table
    name: "Attività aperte"
    order: [file.name, status, formula.days_left]

Errori da evitare, secondo la skill: formule con virgolette doppie non racchiuse tra apici singoli; arrotondare una durata prima di leggerne .days; formule senza controllo sui valori vuoti; riferimenti a formule non definite.

json-canvas

Crea file .canvas secondo la specifica JSON Canvas 1.0: un array di nodi e uno di collegamenti.

• Nodi: testo (con Markdown), file del vault, link esterni e gruppi che contengono altri nodi.
• Collegamenti: da un nodo all'altro, con lato di partenza e arrivo, frecce, etichetta e colore.
• Regole: ID di 16 caratteri esadecimali minuscoli, unici tra nodi e collegamenti; ogni collegamento deve puntare a nodi esistenti; colori "1"–"6" o esadecimali; coordinate dall'angolo in alto a sinistra, con y che cresce verso il basso, e nodi distanziati di 50–100 px.

defuddle

Estrae il contenuto principale di una pagina web come Markdown pulito, senza menu e pubblicità, così l'agente consuma meno token. La skill dice di preferirlo al normale recupero delle pagine web per le pagine comuni.

npm install -g defuddle                         # se non è installato
defuddle parse <url> --md                       # Markdown
defuddle parse <url> --md -o contenuto.md       # salva su file
defuddle parse <url> -p title                   # solo un metadato (title, description, domain)

knap

Genera documenti Markdown da un modello con variabili, filtri e condizioni, riempito con dati JSON o CSV. Richiede Node.js 20 o successivo (npm install -g knap, oppure npx knap).

knap render modello.md --data articolo.json -o nota.md
knap batch modello.md --data articoli.csv --output-dir note --filename '{{ title | safe_name }}.md'
knap validate modello.md

Sintassi dei modelli: {{ variabile }}, {{ variabile | filtro }}, {% if condizione %} ... {% endif %}. Si combina con defuddle per trasformare una pagina web in nota:

defuddle parse https://example.com --md --json | knap render modello.md --data -

Da sapere

• Le skill sui formati funzionano ovunque: obsidian-markdown, obsidian-bases e json-canvas contengono solo regole di sintassi e non eseguono niente.
• obsidian-cli richiede Obsidian sul computer in cui gira l'agente. Con eval l'agente può eseguire JavaScript dentro l'app, con accesso a tutto il vault.
• defuddle e knap richiedono Node.js e installano pacchetti npm globali; defuddle si collega a internet per scaricare le pagine.
• Dove installarla: il README suggerisce, per Claude Code, di metterla nella cartella .claude alla radice del vault. Così Claude Code la usa quando lo apri dentro il vault.

Installazione

Da terminale con npx skills (Claude Code, Codex, OpenCode)

Serve Node.js. Tutte le skill, per Claude Code e Codex, a livello globale:

npx skills add https://github.com/kepano/obsidian-skills -g -a claude-code -a codex

Il README mostra prima la forma SSH (npx skills add git@github.com:kepano/obsidian-skills.git), che richiede una chiave configurata su GitHub; la forma HTTPS qui sopra non ne ha bisogno.

Solo alcune skill, ripetendo --skill:

npx skills add kepano/obsidian-skills --skill obsidian-markdown --skill obsidian-bases -g -a claude-code -a codex

Opzione	Significato
--skill <nome>	installa solo la skill indicata; senza, lo strumento propone tutte e sei
-g	globale (~/.claude/skills/, ~/.codex/skills/); senza, solo nel progetto corrente, per esempio dentro il vault
-a <agente>	agente di destinazione, ripetibile
-y	salta le domande di conferma

Gestione: npx skills list -g, npx skills update, npx skills remove <nome>. Dopo l'installazione riavvia la sessione; in Codex le skill si richiamano con $<nome>, per esempio $obsidian-markdown.

Da terminale con git clone (installazione manuale)

git clone --depth 1 https://github.com/kepano/obsidian-skills.git

• Codex: mkdir -p ~/.codex/skills && cp -r obsidian-skills/skills/* ~/.codex/skills/

• Claude Code: copia il contenuto del repository in una cartella .claude alla radice del vault (o della cartella in cui usi Claude Code).

• OpenCode: clona l'intero repository, non solo skills/, in ~/.opencode/skills/obsidian-skills, così che il percorso sia ~/.opencode/skills/obsidian-skills/skills/<skill>/SKILL.md:

  git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills
  

  OpenCode le trova da solo, senza toccare opencode.json; riavvialo per attivarle.

Claude Code come plugin

Dentro una sessione di Claude Code:

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

Il plugin si chiama obsidian e comprende tutte le skill. Aggiornamento: /plugin marketplace update obsidian-skills; rimozione: /plugin uninstall obsidian@obsidian-skills.

App desktop di Claude e ChatGPT

Il README non documenta l'uso nelle app desktop. Ogni skill va caricata come ZIP separato:

git clone --depth 1 https://github.com/kepano/obsidian-skills.git
cd obsidian-skills/skills
for s in obsidian-markdown obsidian-bases json-canvas; do zip -r ~/$s.zip $s; done

• Claude (desktop o web): attiva l'esecuzione del codice in Settings → Capabilities, poi Customize → Skills → + → Create skill → Upload a skill, scegli lo ZIP e attiva l'interruttore.
• ChatGPT (desktop o web): Skills nella barra laterale, poi Create → Upload from your computer; richiamala con @. Le skill caricate su desktop e web non si sincronizzano.

Qui hanno senso solo le tre skill sui formati: l'agente scrive il contenuto di note, .base e .canvas che poi copi nel vault. obsidian-cli non può funzionare, perché le app lavorano in un ambiente isolato senza accesso al tuo Obsidian. defuddle e knap dipendono dalla possibilità di installare pacchetti npm, che non ho verificato.

Fonti

• README di kepano/obsidian-skills
• SKILL.md di obsidian-markdown
• SKILL.md di obsidian-cli
• SKILL.md di obsidian-bases
• SKILL.md di json-canvas
• SKILL.md di defuddle
• SKILL.md di knap
• kepano/obsidian-skills su skills.sh
• Obsidian CLI – Obsidian Help
• README di vercel-labs/skills
• Use skills in Claude – Claude Help Center
• Skills in ChatGPT – OpenAI Help Center