🎓Skill

Le skill sono istruzioni che Claude Code carica da solo quando un'attività corrisponde alla loro descrizione. Claude Maxxing installa le sue skill in ~/.claude/skills/, così sono disponibili in ogni sessione. Le copie indicano le cartelle reali della tua installazione (codice, workspace, stato), quindi restano corrette anche se l'installer ha usato percorsi diversi da quelli predefiniti; maxxing init (eseguito a ogni aggiornamento) le riscrive.

Skill incluse

Skill	Claude la usa quando
`memory`	uno scambio ha prodotto qualcosa di duraturo: lo registra nel memory.md giusto
`memory-compaction`	i file di memoria sono diventati troppo lunghi o contraddittori (viene eseguita ogni giorno anche da un job)
`maxxing-setup`	dici "configura Harness Maxxing", o vuoi completare/verificare un'installazione
`maxxing-doctor`	qualcosa non funziona: interfaccia non raggiungibile, sessioni che falliscono, job che non partono
`maxxing-telegram`	configuri o risolvi problemi del collegamento con Telegram
`maxxing-backup`	configuri, esegui o ripristini il backup, o passi a un nuovo server
`maxxing-cron`	vuoi che qualcosa avvenga a orari programmati
`maxxing-tasks`	parli delle tue attività o della bacheca
`maxxing-feed`	dici "avvisami quando…", o vuoi ricevere notifiche su vendite, ordini, deploy, e-mail o risultati di uno script (webhook, `maxxing feed post`)
`maxxing-mcp`	vuoi che Claude usi un servizio tramite MCP ("collega l'MCP di Google Ads"), uno strumento MCP manca o richiede un accesso
`maxxing-extension`	vuoi un widget per la dashboard (Card, o HTML: un gioco, un canvas) o una pagina personalizzata
`maxxing-customize`	vuoi modificare il prodotto stesso, o un aggiornamento segnala che le tue personalizzazioni vanno adattate
`video-motion-design`	chiedi un video, un'animazione, uno short / reel o un trailer (Remotion, vedi Video, PDF e immagini)
`pdf-document`	chiedi un PDF: un preventivo, una fattura, un report, una guida
`image-edit`	vuoi ridimensionare, convertire, comprimere o elaborare immagini in blocco
`seo-audit`	chiedi un audit SEO o perché un sito non si posiziona
`web-scraping`	vuoi raccogliere dati da un sito web (prezzi, catalogo, annunci…) o tenere sotto controllo una pagina per rilevarne i cambiamenti

Puoi anche nominare una skill in modo esplicito: "usa la skill maxxing-doctor".

maxxing init e maxxing update le mantengono aggiornate. Sovrascrivono solo le skill del prodotto (i nomi che iniziano con maxxing-, più memory, memory-compaction, video-motion-design, pdf-document, image-edit, seo-audit e web-scraping). Se esisteva già una skill con uno di questi nomi, viene prima spostata in /var/lib/claude-maxxing/trash/skills/.

Aggiungere le tue skill

Crea una cartella con un file SKILL.md:

~/.claude/skills/blog-article/SKILL.md            user level: available in every session
/root/maxxing/.claude/skills/blog-article/SKILL.md  workspace level: included in the memory backup

---
name: blog-article
description: Write and publish a blog article for the Acme blog. Use when asked for a new article, a draft, or the next subject of the editorial plan.
---

# Blog article

1. Pick the next subject in projects/acme/topics/blog/plan.md ...
2. ...

Consigli: - La descrizione decide quando Claude usa la skill: indica cosa fa e quando usarla. - Scrivi il corpo come una procedura precisa: passaggi, percorsi, comandi, controlli, cosa non fare mai. - Il nome e la descrizione di ogni skill vengono inviati a ogni prompt di ogni sessione. Oltre il budget di Claude Code (circa 8.000 caratteri), le descrizioni delle skill meno usate vengono scartate e Claude le sceglie in modo meno affidabile - maxxing doctor mostra il totale. Tieni una skill che usa un solo progetto in quel progetto (projects/<p>/.claude/skills/: caricata solo nei suoi topic), oppure aggiungi disable-model-invocation: true al suo frontmatter, così solo tu puoi richiamarla (/name). - Metti gli script di supporto accanto a SKILL.md e richiamali con il loro percorso. - Chiedi a Claude di scrivere la skill al posto tuo dopo aver svolto insieme un'attività una prima volta: "trasforma quello che abbiamo appena fatto in una skill". - Le skill personalizzate non vengono mai sovrascritte dagli aggiornamenti. Le skill in <workspace>/.claude/skills/ sono incluse nel backup; le skill a livello utente in ~/.claude/skills/ no. - Controlla come la tua versione di Claude Code rileva le skill a livello di progetto (claude --help, documentazione di Claude Code) se una skill del workspace non viene individuata in una sessione di un topic; il livello utente funziona sempre.