diff --git a/README.md b/README.md index d3f17fc..09268da 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,7 @@ Il mio dizionario delle skill per agenti AI (Claude Code, Codex, app di Claude e | Skill | Descrizione | |---|---| +| [claude-plugins-official](skills/claude-plugins-official.md) | Marketplace ufficiale di Anthropic per Claude Code: catalogo di plugin con integrazioni, analisi del codice e flussi di sviluppo. | | [find-skills](skills/find-skills.md) | Permette all'agente di cercare e installare da solo altre skill con `npx skills`. | | [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). | diff --git a/skills/claude-plugins-official.md b/skills/claude-plugins-official.md new file mode 100644 index 0000000..31b18ad --- /dev/null +++ b/skills/claude-plugins-official.md @@ -0,0 +1,124 @@ +# claude-plugins-official + +- **Autore:** Anthropic +- **Repository:** [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) (licenza Apache-2.0; ogni plugin ha la sua licenza) +- **Catalogo online:** [claude.com/plugins](https://claude.com/plugins) +- **Documentazione:** [Discover and install prebuilt plugins](https://code.claude.com/docs/en/discover-plugins) +- **Diffusione (settembre 2026):** circa 36.700 stelle e 4.100 fork su GitHub + +> Non è una singola skill ma il **marketplace ufficiale di plugin per Claude Code**: un catalogo da cui installare plugin. Ogni plugin può contenere skill, agenti, comandi, hook, server MCP e server LSP. + +## A cosa serve + +Raccoglie in un unico posto i plugin curati da Anthropic per estendere Claude Code: integrazioni con servizi esterni (GitHub, Jira, Slack...), analisi del codice per linguaggio, flussi di lavoro di sviluppo (commit, revisione delle PR) e strumenti per creare plugin e skill propri. + +## Cosa fa + +### Come funziona un marketplace + +Usare un marketplace richiede due passi: + +1. **aggiungere il marketplace**, cioè registrare il catalogo in Claude Code (non installa ancora niente); +2. **installare i singoli plugin** scelti dal catalogo. + +`claude-plugins-official` fa eccezione per il primo passo: Claude Code lo aggiunge da solo al primo avvio interattivo. + +Le skill di un plugin prendono come prefisso il nome del plugin: per esempio `commit-commands` offre `/commit-commands:commit`. + +### Cosa contiene + +Il repository ha due cartelle: + +- `plugins/`: 39 plugin sviluppati e mantenuti da Anthropic; +- `external_plugins/`: 14 plugin di partner e della comunità, approvati dopo una revisione di qualità e sicurezza. + +Il catalogo può indicare anche plugin ospitati in altri repository: per esempio `atlassian`, `figma`, `notion` e `vercel` sono nella documentazione ma non in queste cartelle. + +Principali categorie, secondo la documentazione ufficiale: + +| Categoria | Plugin | A cosa servono | +|---|---|---| +| Analisi del codice (LSP) | `clangd-lsp`, `csharp-lsp`, `gopls-lsp`, `jdtls-lsp`, `kotlin-lsp`, `lua-lsp`, `php-lsp`, `pyright-lsp`, `ruby-lsp`, `rust-analyzer-lsp`, `swift-lsp`, `typescript-lsp` | dopo ogni modifica Claude vede subito errori di tipo, import mancanti ed errori di sintassi, e naviga il codice (definizioni, riferimenti, gerarchie di chiamata) | +| Integrazioni esterne (MCP) | `github`, `gitlab`, `atlassian`, `asana`, `linear`, `notion`, `figma`, `vercel`, `firebase`, `supabase`, `slack`, `sentry` | collegano Claude ai servizi senza configurazione manuale | +| Sicurezza | `security-guidance` | controlla ogni modifica di Claude per le vulnerabilità più comuni e le fa correggere nella stessa sessione | +| Flussi di sviluppo | `commit-commands`, `pr-review-toolkit`, `agent-sdk-dev`, `plugin-dev` | commit, push e PR; agenti per revisionare le PR; strumenti per Claude Agent SDK; strumenti per creare plugin | +| Stili di risposta | `explanatory-output-style`, `learning-output-style` | spiegazioni didattiche sulle scelte di implementazione; modalità di apprendimento interattiva | + +Altri plugin di Anthropic presenti nel repository, non descritti nella documentazione citata: `claude-code-setup`, `claude-md-management`, `claude-security`, `code-modernization`, `code-review`, `code-simplifier`, `cwc-makers`, `example-plugin`, `feature-dev`, `frontend-design`, `hookify`, `math-olympiad`, `mcp-server-dev`, `mcp-tunnels`, `playground`, `project-artifact`, `ralph-loop`, `receipts`, `session-report`, `skill-creator`. + +Plugin esterni nel repository: `asana`, `context7`, `discord`, `fakechat`, `firebase`, `github`, `gitlab`, `imessage`, `laravel-boost`, `linear`, `playwright`, `serena`, `telegram`, `terraform`. + +### Da sapere + +- **Fiducia:** i plugin possono eseguire codice sul tuo computer con i tuoi permessi. Anthropic avverte che non controlla il contenuto dei plugin (server MCP, file, software) e non può garantire che funzionino come previsto. Prima di installare, controlla la pagina del plugin. +- **Plugin LSP:** non installano il language server; va installato a parte (per esempio `pyright-langserver` per `pyright-lsp`). Se manca, la scheda **Errors** di `/plugin` mostra `Executable not found in $PATH`. Alcuni server, come `rust-analyzer` e `pyright`, usano molta memoria sui progetti grandi. Nelle sessioni cloud non vengono avviati. +- **Costo:** ogni plugin aggiunge token al contesto a ogni turno. La scheda del plugin in `/plugin` ne mostra una stima, e la scheda **Installed** segnala i plugin non usati da almeno due settimane. +- **Aggiornamenti:** per questo marketplace l'aggiornamento automatico è attivo di default. +- **Marketplace della comunità:** esiste anche [anthropics/claude-plugins-community](https://github.com/anthropics/claude-plugins-community), con plugin di terzi passati da controlli automatici. Va aggiunto a mano con `/plugin marketplace add anthropics/claude-plugins-community`, e i plugin si installano con `@claude-community`. I moduli di invio dentro l'app aggiungono plugin a questo marketplace, non a quello ufficiale. + +## Installazione + +### Claude Code (terminale) + +Il marketplace è già presente. Per sfogliarlo, apri `/plugin` e vai nella scheda **Discover**. Per installare un plugin: + +``` +/plugin install @claude-plugins-official +``` + +Per esempio `/plugin install github@claude-plugins-official`. Poi scegli dove installarlo: + +| Ambito | Effetto | +|---|---| +| User | per te, in tutti i progetti | +| Project | per tutti i collaboratori del repository (scritto in `.claude/settings.json`) | +| Local | solo per te, solo in questo repository | + +Se Claude Code risponde `Marketplace "claude-plugins-official" not found`, aggiungilo a mano: + +``` +/plugin marketplace add anthropics/claude-plugins-official +``` + +Gestione: + +``` +/plugin list # plugin installati +/plugin disable @claude-plugins-official # disattiva senza rimuovere +/plugin enable @claude-plugins-official # riattiva +/plugin uninstall @claude-plugins-official # rimuove +/plugin marketplace update claude-plugins-official # aggiorna il catalogo +/reload-plugins # applica le modifiche senza riavviare +``` + +Da shell, senza passaggi interattivi (ambito user, se non indichi `--scope`): + +```bash +claude plugin install @claude-plugins-official +claude plugin install @claude-plugins-official --scope project +claude plugin uninstall @claude-plugins-official +``` + +Se le skill di un plugin non compaiono, la documentazione indica di svuotare la cache con `rm -rf ~/.claude/plugins/cache`, riavviare Claude Code e reinstallare il plugin. + +### App desktop di Claude (sezione Claude Code) + +Nelle sessioni locali o SSH: + +1. clicca **+** accanto alla casella del messaggio; +2. scegli **Plugins → Add plugin**; +3. sfoglia i plugin dei marketplace configurati, compreso quello ufficiale, e installa quello che vuoi. + +Dallo stesso menu puoi attivarli, disattivarli o rimuoverli (**Manage plugins**). Gli ambiti sono gli stessi del terminale. Il browser dei plugin non c'è nelle sessioni cloud e nelle sessioni WSL. Per usare un plugin nelle sessioni cloud, attivalo sul tuo account claude.ai: Claude Code lo carica come plugin sincronizzato. + +### Codex e ChatGPT + +Il marketplace è fatto per Claude Code, e la documentazione non ne descrive l'uso in Codex o ChatGPT. I singoli plugin che contengono skill (cartelle `skills/` con `SKILL.md`) si potrebbero in teoria adattare, ma non è un uso documentato. + +## Fonti + +- [README di anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) +- [Cartella plugins/](https://github.com/anthropics/claude-plugins-official/tree/main/plugins) +- [Cartella external_plugins/](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins) +- [Discover and install prebuilt plugins – Claude Code Docs](https://code.claude.com/docs/en/discover-plugins) +- [Claude Code desktop – Claude Code Docs](https://code.claude.com/docs/en/desktop)