Aggiungi la scheda di obsidian-wiki e aggiorna l'installazione di obsidian-skills

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-16 09:23:21 +02:00
1 parent 13cae124c3
commit d9585e303a
@@ -10,6 +10,7 @@ Il mio dizionario delle skill per agenti AI (Claude Code, Codex, app di Claude e
 | [find-skills](skills/find-skills.md) | Permette all'agente di cercare e installare da solo altre skill con `npx skills`. |
 | [graphify](skills/graphify.md) | Trasforma codice, documenti e media di un progetto in un grafo di conoscenza che l'agente interroga invece di rileggere i file. |
 | [obsidian-skills](skills/obsidian-skills.md) | Raccolta ufficiale di sei skill per Obsidian: Markdown di Obsidian, Bases, Canvas, riga di comando, estrazione di pagine web e modelli. |
+| [obsidian-wiki](skills/obsidian-wiki.md) | Framework di 39 skill che fa costruire all'agente un "secondo cervello": un vault Obsidian di note collegate che raccoglie documenti, sessioni e progetti e risponde con citazioni. |
 | [ponytail](skills/ponytail.md) | Fa scrivere all'agente il codice più semplice e breve che funziona, evitando la sovraingegnerizzazione. |
 | [project-estimation](skills/project-estimation.md) | Stima durata, costi e risorse di un progetto con tecniche strutturate (PERT, bottom-up, per analogia). |
 | [ui-ux-pro-max](skills/ui-ux-pro-max.md) | Dà all'agente un archivio di stili, palette, font e regole di UX per progettare interfacce curate su web, mobile e desktop. |
@@ -134,26 +134,17 @@ defuddle parse https://example.com --md --json | knap render modello.md --data -

 ## Installazione

-### Claude Code come plugin
+### Da terminale con `npx skills` (Claude Code, Codex, OpenCode)

-Nella 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. Gestione con `/plugin marketplace update obsidian-skills` e `/plugin uninstall obsidian@obsidian-skills`.
-
-### Claude Code e Codex con `npx skills`
-
-Tutte le skill:
+Serve Node.js. Tutte le skill, per Claude Code e Codex, a livello globale:

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

-Solo alcune, ripetendo `--skill`:
+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
@@ -162,25 +153,38 @@ npx skills add kepano/obsidian-skills --skill obsidian-markdown --skill obsidian
 | Opzione | Significato |
 |---|---|
 | `--skill <nome>` | installa solo la skill indicata; senza, lo strumento propone tutte e sei |
-| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente, per esempio dentro il vault |
+| `-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 con `npx skills list -g`, `npx skills update` e `npx skills remove <nome>`.
+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`.

-### Installazione manuale
-
-Come indicato nel README:
-
- **Claude Code:** copia il contenuto del repository nella cartella `.claude` alla radice del vault.
- **Codex:** copia la cartella `skills/` in `~/.codex/skills`.
+### Da terminale con `git clone` (installazione manuale)

 ```bash
 git clone --depth 1 https://github.com/kepano/obsidian-skills.git
-cp -r obsidian-skills/skills/* ~/.codex/skills/
 ```

-Dopo l'installazione riavvia la sessione. In Codex puoi richiamare le skill con `$<nome>`, per esempio `$obsidian-markdown`.
+- **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

@@ -0,0 +1,185 @@
+# obsidian-wiki
+
+- **Autore:** Ar9av
+- **Repository:** [Ar9av/obsidian-wiki](https://github.com/Ar9av/obsidian-wiki) (licenza MIT)
+- **Sorgenti:** cartella [.skills/](https://github.com/Ar9av/obsidian-wiki/tree/main/.skills), un `SKILL.md` per skill; l'elenco commentato è in [docs/skills.md](https://github.com/Ar9av/obsidian-wiki/blob/main/docs/skills.md)
+- **Pagina su skills.sh:** [Ar9av/obsidian-wiki](https://skills.sh/Ar9av/obsidian-wiki)
+- **Diffusione (ottobre 2026):** circa 97.200 installazioni complessive tramite `npx skills` su 44 skill; il repository ha circa 3.600 stelle e 361 fork su GitHub
+- **Controlli di sicurezza su skills.sh:** per `wiki-ingest`, Gen Agent Trust Hub e Snyk segnalano un avviso (la pagina non spiega il motivo) e Socket è elencato senza esito. La pagina riassuntiva del repository non riporta audit e la sua sezione `/audits` dà errore 404. Le altre skill non le ho controllate.
+
+> Non è una sola skill ma un **framework di 39 skill** (skills.sh ne elenca 44, tra cui `data-ingest`, `ingest-url`, `obsidian-wiki-ingest` e `wiki-quick-chat-capture`, che non compaiono nella cartella `.skills/` né nella documentazione; non ho verificato perché), più una CLI e un'API Python facoltative. Le skill sono pensate per funzionare insieme, attorno a un'unica cartella di note.
+
+## A cosa serve
+
+Dà all'agente una memoria a lungo termine fatta di note Markdown che sono tue: un "secondo cervello" in formato vault di [Obsidian](https://obsidian.md). Risolve il problema di rifare da zero un lavoro già fatto perché la risposta era finita in una chat dimenticata. Segue l'idea del [gist LLM Wiki di Karpathy](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f): la conoscenza si compila una volta e si mantiene aggiornata, invece di rifare ogni volta la stessa domanda a un LLM o una ricerca RAG.
+
+## Cosa fa
+
+### Quando si attiva
+
+Le skill partono quando la richiesta corrisponde alla loro descrizione, oppure con un comando `/nome-skill` (nei client che li supportano, come Claude Code):
+
+- vuoi inizializzare il sistema ("set up my wiki");
+- vuoi "dare in pasto" all'agente documenti, PDF, esportazioni di chat, trascrizioni, immagini o URL;
+- vuoi salvare la conversazione corrente o la conoscenza del progetto in cui stai lavorando;
+- chiedi che cosa sai già su un argomento, o vuoi un riepilogo di quanto hai imparato in un periodo;
+- vuoi ritrovare una vecchia sessione con l'agente o recuperare quanto emerso nelle sessioni passate;
+- vuoi tenere in ordine il vault (link rotti, duplicati, tag incoerenti).
+
+### Come lavora
+
+1. **Imposta il vault.** `wiki-setup` chiede dove creare il vault e dove sono i documenti sorgente, poi crea cartelle, `index.md`, `log.md`, `hot.md`, il manifest `.manifest.json` e la configurazione di Obsidian. Con la CLI Python lo stesso risultato si ottiene con `obsidian-wiki setup`.
+2. **Distilla le fonti** (`wiki-ingest`). Non riassume: integra la conoscenza nelle pagine già presenti, segnala le contraddizioni e aggiorna i collegamenti. Tre modalità: *append* (predefinita, tratta solo fonti nuove o modificate, verificate con un hash tramite `obsidian-wiki cache-check`), *full* (rifà tutto) e *raw* (promuove le bozze messe in `_raw/` e le archivia in `_raw/_archived/`). Il testo delle fonti è trattato come dato non fidato: la skill dice di non eseguire comandi trovati nei documenti.
+3. **Sincronizza i progetti** (`wiki-update`). Dalla cartella di un repository confronta lo stato con l'ultimo commit sincronizzato, ricava che cosa varrebbe la pena ricordare tra tre mesi e lo scrive nel vault. Funziona da qualsiasi progetto.
+4. **Risponde alle domande** (`wiki-query`). È in sola lettura: scrive soltanto una riga in `log.md`. Parte da `hot.md` e `index.md`, poi legge le sezioni e solo in ultimo le pagine intere, così il costo resta quasi costante al crescere del vault. La risposta cita le pagine con `[[wikilink]]`, elenca le lacune e dichiara quanti candidati ha visto e letto.
+5. **Mantiene il vault in ordine** con `wiki-lint`, `wiki-dedup`, `cross-linker`, `tag-taxonomy`, `wiki-synthesize` e `wiki-status`.
+
+Esempi dal README:
+
+```text
+/wiki-ingest ~/research
+/wiki-update                        # distilla il repository in cui ti trovi
+/wiki-capture                       # salva questa conversazione
+/wiki-history-ingest claude         # estrae il sapere dalle tue vecchie sessioni con Claude
+/wiki-query what do I know about rate limiting?
+/wiki-narrate MCP security          # briefing con citazioni su un argomento
+/wiki-digest week                   # che cosa ho imparato questa settimana?
+```
+
+### Le skill per gruppo
+
+| Gruppo | Skill |
+|---|---|
+| Impostazione | `wiki-setup`, `wiki-switch` (più vault con nome), `daily-update` |
+| Alimentare il vault | `wiki-ingest`, `wiki-capture` (con `--quick` mette in `_raw/` in meno di 60 secondi), `wiki-update`, `wiki-research` (ricerca web autonoma), `wiki-history-ingest` e le sei skill `claude-`, `codex-`, `copilot-`, `hermes-`, `openclaw-`, `pi-history-ingest`, `wiki-agent` |
+| Interrogarlo | `wiki-query`, `wiki-narrate`, `wiki-digest`, `wiki-context-pack` (porzione di contesto limitata in token per un altro agente), `memory-bridge` (che cosa ha scritto ogni strumento) |
+| Ritrovare le sessioni | `session-brain`, `session-search` |
+| Manutenzione | `wiki-status`, `wiki-lint`, `wiki-dedup`, `cross-linker`, `tag-taxonomy`, `wiki-synthesize`, `wiki-stage-commit`, `wiki-rebuild` |
+| Vedere e spostare | `graph-colorize`, `wiki-dashboard`, `wiki-export`, `wiki-import`, `obsidian-layout-adjustment` |
+| Estendere | `llm-wiki` (il riferimento del metodo), `skill-creator`, `vault-skill-factory`, `impl-validator`, `code-understand` |
+
+Le due skill sulle sessioni non toccano il vault: scrivono un indice a parte in `~/.claude/session-brain/`. Regola pratica del progetto: `wiki-history-ingest` per conservare la conoscenza come pagine permanenti, `session-brain` per ritrovare la sessione in cui è successo qualcosa.
+
+### Come tiene la conoscenza affidabile
+
+- Ogni affermazione è marcata come estratta dalla fonte, `^[inferred]` oppure `^[ambiguous]`; `wiki-lint` segnala le pagine che scivolano nella speculazione.
+- Un manifest registra ogni fonte già letta, così la seconda esecuzione tratta solo la differenza.
+- `index.md`, `log.md`, `hot.md`, il profilo del proprietario e l'indice dei todo (sotto `_meta/`) passano da un unico writer con blocco, per evitare che agenti in parallelo si sovrascrivano.
+- Con `WIKI_STAGED_WRITES=true` le pagine nuove finiscono prima in `_staging/` e le promuovi tu con `/wiki-stage-commit`.
+- Più vault: `@nome` davanti alla richiesta la indirizza a un vault con nome (`@work update wiki`) senza cambiare quello predefinito.
+
+### Parti facoltative
+
+- **CLI Python** `obsidian-wiki`: `setup`, `doctor`, `info`, `hooks status|install|uninstall`, `cache-check`, `cache-update`, `sessions-build`, `sessions-query`, `sessions-show`, `sessions-clusters` e altri (elenco completo nella [guida alla CLI](https://github.com/Ar9av/obsidian-wiki/blob/main/docs/cli.md), che ho letto solo in parte).
+- **API Python:** `from obsidian_wiki import Memory`, con `remember`, `add`, `search`, `recap`. Dice di non richiedere chiavi API, modello di embedding né rete.
+- **Esportazione del grafo** in `graph.json`, GraphML, Neo4j Cypher, Postgres SQL, `graph.html` interattivo o pacchetto OKF.
+- **Estensione per il browser** e **servizio Docker** raggiungibile via HTTP/MCP (`obsidian-wiki serve`, ascolta solo in locale per impostazione predefinita). Li ho visti solo nell'indice della documentazione, non ne ho letto le guide.
+- **Ricerca semantica QMD** e **sincronizzazione su GitHub**, da attivare nella configurazione.
+
+### Risultati dichiarati
+
+Il README riporta un confronto su un vault reale di 38 pagine con Claude Sonnet: 81 s contro 19 s per rispondere e 44% contro 83% di risposte corrette, a costo API invariato. Il campione è minuscolo (4 domande, 2 condizioni, 2 ripetizioni) e gli autori lo definiscono indicativo; in una delle prove "con il tool" il modello ha ignorato la CLI e ha sbagliato. Il confronto con altri strumenti nel README è una valutazione del progetto stesso.
+
+### Da sapere
+
+- **Hook di sessione:** `obsidian-wiki setup` registra due hook di Claude Code, uno che all'avvio inserisce nel contesto la memoria del vault e uno a fine sessione che chiede di eseguire `/wiki-capture --quick` se hai modificato file o lanciato almeno 4 comandi. Si salta con `--no-hooks`, si rimuove con `obsidian-wiki hooks uninstall`, e `WIKI_STOP_CAPTURE=false` lo disattiva per una singola sessione. Il plugin di Claude Code non li installa.
+- **Cronologia delle sessioni:** le skill `*-history-ingest` e `session-brain` leggono le sessioni passate (`~/.claude`, `~/.codex`, `~/.copilot`, ecc.), che possono contenere segreti o dati sensibili. Anche `wiki-update` legge README, sorgenti, log di git e file `.claude/` del progetto.
+- **Scritture fuori dal vault:** `setup` crea collegamenti simbolici delle skill nelle cartelle di tutti gli agenti rilevati (`~/.claude`, `~/.codex`, `~/.gemini`, ecc.) e file di regole sempre attive nel progetto (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`...). Scrive anche la configurazione in `~/.config/obsidian-wiki/config` e un profilo di scrittura `WRITING.md`.
+- **Installazione dell'hook da parte dell'agente:** `wiki-setup` può scaricare con `curl` lo script `wiki-stop-capture.sh` dal repository e aggiungerlo a `~/.claude/settings.json`; chiede conferma prima ("Want to auto-capture findings at session end?").
+- **Setup guidato dall'agente:** dando all'agente solo l'URL del repository, esegue lui i comandi indicati nelle istruzioni. Conviene leggerle prima.
+- **Uscita dei dati:** il README dice che nulla lascia il computer. Fanno eccezione le funzioni che attivi tu: sincronizzazione GitHub, servizio HTTP/MCP e estensione browser, che può anche compilare form web con dati del vault.
+- **Prompt injection:** le skill di ingest dichiarano le fonti dati non fidati, ma la politica di sicurezza del progetto riconosce l'ingestione di contenuti non controllati come il punto di rischio principale (scritture fuori dal vault, segreti nel vault o in `log.md`, istruzioni nascoste nei documenti). Il progetto non considera una vulnerabilità un agente che fa ciò che gli hai permesso di fare.
+- **Requisiti:** Python per la CLI e l'API (versione non indicata nei documenti che ho letto). Obsidian è facoltativo, serve per grafo e navigazione. Docker solo per il servizio.
+- **Maturità:** l'autore lo definisce "early".
+
+## Installazione
+
+### Claude Code e Codex
+
+Percorso consigliato dal progetto, con la CLI Python (installa le skill in tutti gli agenti rilevati, comprese Claude Code e Codex):
+
+```bash
+pip install obsidian-wiki
+obsidian-wiki setup --vault ~/brain
+```
+
+Poi apri un progetto nell'agente e di': **"set up my wiki"**.
+
+| Opzione o comando | Significato |
+|---|---|
+| `uv tool install obsidian-wiki` / `pipx install obsidian-wiki` | alternative a `pip`; non usare `uvx` perché i collegamenti delle skill punterebbero a un ambiente temporaneo (se serve, `uvx obsidian-wiki setup --copy`) |
+| `--vault <percorso>` | cartella del vault (nuova o già vault Obsidian); se manca te la chiede |
+| `--no-hooks` | non registra i due hook di sessione |
+| `--copy` | copia i file delle skill invece di creare collegamenti simbolici |
+| `--project .` | aggiunge anche skill locali e `AGENTS.md` al progetto corrente |
+| `--timezone <fuso>` | fuso orario per le date scritte nel vault |
+
+Alternative:
+
+- **Plugin per Claude Code** (senza Python, solo skill: niente hook né CLI):
+
+  ```text
+  /plugin marketplace add Ar9av/obsidian-wiki
+  /plugin install obsidian-wiki@obsidian-wiki
+  ```
+
+  I comandi hanno il prefisso del plugin, per esempio `/obsidian-wiki:wiki-ingest`. Poi di' "set up my wiki" per impostare il vault.
+- **Clone del repository:** `git clone https://github.com/Ar9av/obsidian-wiki.git && cd obsidian-wiki && bash setup.sh`.
+- **Skills CLI** (`npx skills add Ar9av/obsidian-wiki -g -a claude-code -a codex`): il progetto la dichiara **deprecata**, perché installa solo le skill nell'agente corrente senza scrivere la configurazione globale né i collegamenti agli altri agenti.
+
+Verifica e gestione:
+
+```bash
+obsidian-wiki doctor            # controlla installazione e stato del vault
+obsidian-wiki info              # mostra i percorsi risolti
+obsidian-wiki hooks status      # gli hook sono registrati e raggiungibili?
+obsidian-wiki hooks uninstall   # toglie solo gli hook di questo progetto
+pip install -U obsidian-wiki    # aggiornamento (con uv: uv tool upgrade obsidian-wiki; con pipx: pipx upgrade obsidian-wiki)
+obsidian-wiki setup             # da rilanciare dopo l'aggiornamento per avere le skill nuove
+```
+
+Per il plugin: `claude plugin marketplace update obsidian-wiki`, poi `claude plugin update obsidian-wiki@obsidian-wiki` e riavvio di Claude Code. Il progetto non documenta nei file che ho letto un comando di disinstallazione completo della CLI (collegamenti simbolici, configurazione): non l'ho verificato. In Claude Code, `/plugin uninstall obsidian-wiki@obsidian-wiki` rimuove il plugin. Dopo l'installazione riavvia la sessione; in Codex le skill si richiamano con `$nome` (per esempio `$wiki-query`) e si vedono con `/skills`.
+
+### App desktop di Claude e ChatGPT
+
+Il README non documenta l'uso nelle app desktop. Ogni skill va caricata come ZIP separato, con la cartella della skill che contiene `SKILL.md`:
+
+```bash
+git clone --depth 1 https://github.com/Ar9av/obsidian-wiki.git
+cd obsidian-wiki/.skills && zip -r ~/wiki-query.zip wiki-query
+```
+
+**Claude (desktop o web)**
+
+1. Attiva l'esecuzione del codice in **Settings → Capabilities**.
+2. Vai in **Customize → Skills → + → Create skill → Upload a skill** e scegli lo ZIP.
+3. Attiva l'interruttore della skill.
+
+**ChatGPT (desktop o web)**
+
+1. Vai in **Skills** nella barra laterale, poi **Create → Upload from your computer**, e scegli lo ZIP o la cartella.
+2. Attendi l'analisi di sicurezza di ChatGPT.
+3. Richiamala con `@` nella chat.
+
+Le skill personali caricate su desktop e web non si sincronizzano: vanno caricate su ciascuna.
+
+> **Limite:** qui non ha senso usarla. Le skill leggono e scrivono un vault sul tuo disco, usano la CLI `obsidian-wiki`, il file di configurazione in `~/.config/obsidian-wiki/` e gli hook, e le app di chat lavorano in un ambiente isolato senza accesso a queste cose. Serve un agente che giri in locale, come Claude Code o Codex.
+
+## Fonti
+
+- [README di Ar9av/obsidian-wiki](https://github.com/Ar9av/obsidian-wiki)
+- [docs/installation.md](https://github.com/Ar9av/obsidian-wiki/blob/main/docs/installation.md)
+- [docs/skills.md](https://github.com/Ar9av/obsidian-wiki/blob/main/docs/skills.md)
+- [docs/session-brain.md](https://github.com/Ar9av/obsidian-wiki/blob/main/docs/session-brain.md)
+- [docs/cli.md](https://github.com/Ar9av/obsidian-wiki/blob/main/docs/cli.md)
+- [SECURITY.md](https://github.com/Ar9av/obsidian-wiki/blob/main/SECURITY.md)
+- [SKILL.md di wiki-setup](https://github.com/Ar9av/obsidian-wiki/blob/main/.skills/wiki-setup/SKILL.md)
+- [SKILL.md di wiki-ingest](https://github.com/Ar9av/obsidian-wiki/blob/main/.skills/wiki-ingest/SKILL.md)
+- [SKILL.md di wiki-update](https://github.com/Ar9av/obsidian-wiki/blob/main/.skills/wiki-update/SKILL.md)
+- [SKILL.md di wiki-query](https://github.com/Ar9av/obsidian-wiki/blob/main/.skills/wiki-query/SKILL.md)
+- [SKILL.md di wiki-history-ingest](https://github.com/Ar9av/obsidian-wiki/blob/main/.skills/wiki-history-ingest/SKILL.md)
+- [SKILL.md di llm-wiki](https://github.com/Ar9av/obsidian-wiki/blob/main/.skills/llm-wiki/SKILL.md) (letto solo in parte)
+- [obsidian-wiki su skills.sh](https://skills.sh/Ar9av/obsidian-wiki)
+- [wiki-ingest su skills.sh](https://skills.sh/Ar9av/obsidian-wiki/wiki-ingest)
+- [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)