Skip to main content
Nel mondo Mattone la parola “skill” indica due cose diverse, che vivono in posti diversi e le usa chi diverso. Confonderle è la causa più comune di dubbi in onboarding e debug, quindi qui le teniamo separate.
Le due famiglie in una riga:
  • Skill Claude Code → installate in Claude Code (plugin del team o cartella .claude/skills/ di un repo). Le usa il team quando pilota Claude Code (onboarding, editing sicuro, debug). Non finiscono nell’agente ospite.
  • Skill Conduit (agent skill) → caricate nel workspace Conduit dello studente. Le usa l’agente ospite durante le conversazioni. Ognuna è abbinata 1:1 a un custom tool: senza la skill, il tool resta muto.

​
Skill Claude Code (lato team)

Sono le istruzioni operative che carichi in Claude Code. Servono a te (team delivery) per lavorare più in fretta e in sicurezza sugli agenti degli studenti. Si installano come plugin del team o nella cartella .claude/skills/ del repo pertinente e si attivano da sole quando il contesto corrisponde.
Queste skill non vanno caricate nel workspace Conduit dello studente: sono strumenti da scrivania per il team. Vivono nei repo Mattone (o come plugin) e le gestisce centralmente il team tecnico.

​
Skill Conduit (agent skill, lato agente ospite)

Sono le istruzioni di prompting caricate nel workspace Conduit dello studente: dicono all’agente quando usare un tool, quali parametri passare e come interpretare la risposta. Ognuna è abbinata a un custom tool con lo stesso ambito. Senza la sua skill, il tool viene ignorato o produce un fallback nativo inaffidabile. La mappa completa tool ↔ skill (nomi canonici) è nella pagina Custom Tools. In sintesi, per famiglia:
Le agent skill si provisionano insieme ai tool durante l’onboarding e le gestisce il team Mattone: lo studente non le configura da solo. Monti solo le skill dei tool che quello studente usa davvero (chi non ha smart lock non riceve le skill Smart Lock).

​
Regola fondamentale (skill Conduit)

Vale per le agent skill: ogni custom tool deve avere la sua skill abbinata, la coppia è indivisibile.
  • Una skill senza tool è inutile: l’agente riceve istruzioni per fare qualcosa, ma non ha il mezzo per farlo.
  • Un tool senza skill viene ignorato: il mezzo c’è, ma l’agente non sa quando né come usarlo.
Prima di dichiarare un onboarding completato, verifica sempre che ogni tool assegnato allo studente abbia la sua skill abbinata e che entrambi siano attivi nel workspace Conduit. La procedura di verifica è in Custom Tools.
Per aggiungere o modificare una skill (di entrambe le famiglie), contatta il team tecnico. Le skill sono gestite centralmente nei repo Mattone e non sono modificabili dallo studente: eventuali personalizzazioni passano dal team di delivery, che valuta l’impatto sugli altri studenti che usano la stessa skill.