davide
172bfde0e4
Struttura marketplace.json + plugin machine-design, documentazione di architettura e linee guida per la scrittura delle skill. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
52 lines
2.6 KiB
Markdown
52 lines
2.6 KiB
Markdown
# Architettura del repository
|
|
|
|
Questo repository è un **marketplace di plugin Claude** per l'ingegneria meccanica, pensato per essere usato come supporto all'ufficio tecnico nella chat normale di Claude (web e tab Chat di Claude Desktop), non nel tab "Code".
|
|
|
|
## Come funziona l'installazione (target reale)
|
|
|
|
Un plugin bundla più skill in un unico pacchetto installabile. Per installarlo:
|
|
1. In Claude: Customize → Plugins → "+" → Add marketplace → Add from a repository, indicando l'URL di questo repository.
|
|
2. Installare il plugin desiderato (es. `machine-design`): tutte le sue skill diventano disponibili in chat (web e tab Chat di Desktop) e in Cowork.
|
|
|
|
Disponibile su tutti i piani a pagamento (Pro, Max, Team, Enterprise). Nota: hook e sub-agent eventualmente presenti in un plugin funzionano solo in Cowork, ma le skill funzionano ovunque.
|
|
|
|
Questo è lo stesso formato marketplace.json/plugin.json usato da Claude Code — non serve nulla di diverso per il nostro target.
|
|
|
|
## Plugin attivi
|
|
|
|
- **machine-design** (`plugins/machine-design/`): progettazione e verifica di organi meccanici (alberi, cuscinetti, ingranaggi, collegamenti filettati, saldature, molle).
|
|
|
|
## Plugin previsti (non ancora creati)
|
|
|
|
Verranno aggiunti come nuova cartella in `plugins/` + entry in `.claude-plugin/marketplace.json` solo quando si inizia a lavorarci concretamente:
|
|
|
|
- **engineering-materials**: scienza e tecnologia dei materiali (proprietà, trattamenti termici, criteri di scelta materiali).
|
|
- **applied-mechanics**: meccanica applicata alle macchine (cinematica, dinamica, vibrazioni, meccanismi).
|
|
- **manufacturing-engineering**: tecnologia meccanica e processi di produzione (lavorazioni, tolleranze e rugosità, saldatura come processo).
|
|
|
|
## Perché non creare subito le cartelle vuote
|
|
|
|
Una cartella placeholder senza skill reali non aiuta: meglio tenere qui il piano e creare la struttura di un nuovo plugin nel momento in cui si scrive la prima skill di quel dominio.
|
|
|
|
## Struttura di un plugin
|
|
|
|
```
|
|
plugins/<nome-plugin>/
|
|
├── .claude-plugin/
|
|
│ └── plugin.json
|
|
├── skills/
|
|
│ └── <nome-skill>/
|
|
│ └── SKILL.md
|
|
├── README.md
|
|
└── CHANGELOG.md
|
|
```
|
|
|
|
## Vincoli reali sul frontmatter di SKILL.md
|
|
|
|
Campi obbligatori: `name` e `description`.
|
|
|
|
- `name`: max 64 caratteri, solo lettere minuscole/numeri/trattini, niente tag XML, non può contenere "claude" o "anthropic".
|
|
- `description`: non vuota, max 1024 caratteri, niente tag XML. Deve descrivere sia cosa fa la skill sia quando Claude deve usarla (guida l'attivazione automatica).
|
|
|
|
Vedi [skill-guidelines.md](skill-guidelines.md) per le convenzioni di scrittura complete.
|