Files
my-skills/skills/obsidian-skills.md
davideandClaude Sonnet 5.5 c09f4b1f7e Aggiorna le schede con le novità di ottobre 2026
Ponytail 5 (regole, review, audit, installazione), graphify v0.9.91,
catalogo di claude-plugins-official e numeri aggiornati delle altre schede.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-16 09:26:03 +02:00

218 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# obsidian-skills
- **Autore:** kepano (Steph Ango, CEO di Obsidian)
- **Repository:** [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) (licenza MIT)
- **Sorgenti:** cartella [skills/](https://github.com/kepano/obsidian-skills/tree/main/skills), un `SKILL.md` per skill
- **Pagina su skills.sh:** [kepano/obsidian-skills](https://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](https://github.com/tpitsunov/obsidian-skills) e [adriangrantdotorg/Obsidian-Skills](https://github.com/adriangrantdotorg/Obsidian-SKILLS)): questa scheda riguarda solo quello di kepano.
## A cosa serve
Insegna all'agente a lavorare con [Obsidian](https://obsidian.md): 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.
```bash
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à.
```yaml
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](https://jsoncanvas.org/spec/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.
```bash
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`).
```bash
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:
```bash
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:
```bash
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`:
```bash
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)
```bash
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`:
```bash
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:
```bash
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](https://github.com/kepano/obsidian-skills)
- [SKILL.md di obsidian-markdown](https://github.com/kepano/obsidian-skills/blob/main/skills/obsidian-markdown/SKILL.md)
- [SKILL.md di obsidian-cli](https://github.com/kepano/obsidian-skills/blob/main/skills/obsidian-cli/SKILL.md)
- [SKILL.md di obsidian-bases](https://github.com/kepano/obsidian-skills/blob/main/skills/obsidian-bases/SKILL.md)
- [SKILL.md di json-canvas](https://github.com/kepano/obsidian-skills/blob/main/skills/json-canvas/SKILL.md)
- [SKILL.md di defuddle](https://github.com/kepano/obsidian-skills/blob/main/skills/defuddle/SKILL.md)
- [SKILL.md di knap](https://github.com/kepano/obsidian-skills/blob/main/skills/knap/SKILL.md)
- [kepano/obsidian-skills su skills.sh](https://skills.sh/kepano/obsidian-skills)
- [Obsidian CLI – Obsidian Help](https://obsidian.md/help/cli)
- [README di vercel-labs/skills](https://github.com/vercel-labs/skills)
- [Use skills in Claude – Claude Help Center](https://support.claude.com/en/articles/12512180-use-skills-in-claude)
- [Skills in ChatGPT – OpenAI Help Center](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)