📖 Guida installazione

Installa il kit in 5 minuti

Non serve alcuna competenza tecnica. Sono due passi: prima si installa il plugin (le competenze del kit), poi si collega la cartella di lavoro (dove il kit conserva i tuoi fascicoli). Segui le immagini: ogni schermata qui sotto è esattamente quella che vedrai.

1

Il plugin

Il motore: le competenze del penalista, installate da Claude Desktop in pochi clic.

2

La cartella di lavoro

L'archivio: la cartella dove vivono i tuoi fascicoli, le scadenze e i dati dello studio.

1
Installa il plugin
In Claude Desktop — circa 3 minuti
1

Apri «Personalizza»

In Claude Desktop, clicca l'icona Personalizza in basso a sinistra. Si apre la schermata "Personalizza Claude".

Schermata Personalizza Claude
La schermata «Personalizza Claude».
2

Aggiungi il marketplace

Clicca il + in alto → Crea pluginAggiungi marketplace.

Crea plugin, Aggiungi marketplace
Crea plugin → Aggiungi marketplace.
Finestra Aggiungi marketplace vuota
Si apre la finestra «Aggiungi marketplace».

Nel campo URL incolla esattamente questo indirizzo e clicca Sincronizza:

Synthos-Logic/penalista-italia
URL del marketplace inserito
L'indirizzo del marketplace inserito nel campo URL.
3

Installa il plugin

Nella Directory (Plugin → Personale) compare la scheda Penalista Italia di Synthos Logic. Clicca il + sulla scheda.

Scheda del plugin nella directory
La scheda del plugin nella Directory.

Comparirà la conferma «Penalista Italia è installato e pronto all'uso».

Conferma plugin installato
Plugin installato.
4

Controlla la scheda del plugin

Cliccando sul plugin vedi versione, autore e le competenze installate.

Dettaglio del plugin installato
Versione, autore e competenze del plugin.
ℹ️

La versione mostrata deve corrispondere all'ultima release.

5

Attiva gli aggiornamenti automatici (consigliato)

Sempre in Plugin → Personale, accanto al nome penalista-italia ci sono tre puntini (···). Cliccali e attiva «Sincronizza automaticamente». Da quel momento le nuove versioni delle skill arrivano da sole.

⚠️

Se compare una richiesta di autorizzazione GitHub («Concedi»), è la verifica di accesso al repository: serve un account GitHub gratuito. Se non vuoi crearlo, nessun problema — dallo stesso menu puoi usare «Verifica aggiornamenti» quando vuoi, oppure vedi l'installazione alternativa.

6

Verifica

Apri una nuova conversazione e scrivi /penalista-italia:versione. Deve rispondere con la versione del kit e l'elenco delle competenze del kit.

2
Collega la cartella di lavoro
L'archivio dei tuoi fascicoli — circa 2 minuti
1

Scarica lo ZIP

Su github.com/Synthos-Logic/penalista-italia clicca Code → Download ZIP.

2

Decomprimi e rinomina

Decomprimi lo ZIP e rinomina la cartella in Penale-Italia. Mettila dove preferisci (es. Documenti).

3

Collegala a Cowork

Claude Desktop → CoworkSeleziona cartella → scegli Penale-Italia.

Fatto — il primo avvio
Quindici minuti per aprire il primo fascicolo

Ecco come si presenta il kit al lavoro — qui la skill delle misure cautelari raccoglie i dati del fascicolo:

Il kit al lavoro su un fascicolo cautelare
Il kit al lavoro: raccolta dati di un fascicolo cautelare.

Nella conversazione Cowork con la cartella selezionata, scrivi semplicemente:

Iniziamo

Il kit si presenta, raccoglie i dati del tuo studio (nome, foro, tribunale — li chiede una volta sola) e apre con te il primo fascicolo su un caso vero. Quindici minuti.

🧩

Che cosa hai appena installato? Il Passo 1 monta il motore: le competenze del kit (le competenze del kit). Il Passo 2 monta l'archivio: la cartella dove il kit conserva i tuoi fascicoli, le scadenze e i dati del tuo studio. Servono entrambi — il motore senza archivio risponde alle domande, ma non conserva il lavoro sui tuoi casi.

Aggiornare il kit
Quando esce una nuova release

Quando esce una nuova versione (la trovi tra le release), il plugin si aggiorna così:

1. Apri la Directory dei plugin

ImpostazioniPlugin → clicca Sfoglia. Si apre la Directory: vai su PluginPersonale.

2. Sincronizza il catalogo

Accanto al nome del marketplace penalista-italia clicca i tre puntini (···)«Verifica aggiornamenti». Il «Commit sincronizzato» mostrato nel menu deve cambiare: è il segno che il catalogo si è allineato a GitHub.

3. Applica e verifica

Riavvia l'app, apri una conversazione nuova e scrivi /penalista-italia:versione: il comando confronta da solo la versione installata con l'ultima pubblicata su GitHub e ti dice se sei aggiornato.

⚠️

Se il kit resta fermo (dice «aggiornato» ma non lo è). Problema noto dell'app Claude: la sincronizzazione del marketplace può bloccarsi in silenzio. Procedura di sblocco garantita — non tocca fascicoli né Knowledge Base: sul chip penalista-italia clicca ··· → Rimuovi; poi + → Aggiungi marketplace → incolla Synthos-Logic/penalista-italia → Sincronizza; reinstalla il plugin (+ sulla scheda); riavvia l'app e verifica in una conversazione nuova con /penalista-italia:versione.

?
Problemi comuni
Le quattro cose che capitano più spesso
«Questo repository non è un marketplace»

Controlla di aver scritto esattamente Synthos-Logic/penalista-italia (con il trattino).

Claude parla di «le competenze» o risponde con versioni vecchie

Sul computer ci sono residui di versioni precedenti. Pulizia: Personalizza → Skills → elimina le eventuali skill penalista-* caricate singolarmente (il plugin le sostituisce tutte). Poi apri una conversazione nuova.

Ho installato un aggiornamento ma non lo vedo

Gli aggiornamenti valgono per le conversazioni nuove: chiudi quella aperta e aprine un'altra.

Il pulsante «Aggiorna» sulla scheda del plugin è grigio

È normale: prima va sincronizzato il catalogo. Usa i tre puntini (···) accanto al nome del marketplace → «Verifica aggiornamenti».

Il kit dice «aggiornato» ma /versione segnala una versione vecchia

È il blocco silenzioso della sincronizzazione (problema noto dell'app). Segui la procedura di sblocco nella sezione Aggiornare il kit: rimuovi e ri-aggiungi il marketplace. Fascicoli e Knowledge Base non vengono toccati.

💬

Assistenza. Apri una segnalazione su GitHub oppure scrivi a Synthos Logic.