Creare una Skill per Claude Code: Da Video a Documentazione

Ho creato una skill per Claude Code che trasforma video tutorial in documentazione strutturata — con screenshot automatici dei momenti chiave, indicazioni precise su dove cliccare e cosa fare, esportabile in Word, PDF o HTML. Non ha funzionato al primo colpo, ma il processo di costruirla è stato tra le cose più interessanti che ho fatto ultimamente.

L'idea di partenza era semplice: ho spesso video tutorial da cui devo estrarre passaggi precisi. Fare screenshot manualmente, rinominarli, scrivere le istruzioni — è un lavoro ripetitivo che si presta bene all'automazione. E Claude Code è esattamente il posto giusto in cui costruire qualcosa del genere.

Cosa Fa la Skill

Passi un video — un file locale o un link YouTube — e la skill lo analizza, individua i momenti chiave (azioni, click, cambiamenti di schermata), cattura screenshot nei punti rilevanti e genera una documentazione step-by-step precisa e leggibile.

Input flessibile. Funziona sia con video locali sul disco che con URL di YouTube. Non serve scaricare nulla manualmente: se passi un link, ci pensa la skill.

Output sceglibile. La documentazione finale si esporta in Word (.docx), PDF o HTML — a seconda di come vuoi usarla o condividerla. Ogni step include il relativo screenshot e la descrizione dell'azione.

Come L'ho Costruita

La skill è scritta in Python e l'ho costruita direttamente con Claude Code. Il processo è stato collaborativo: descrivevo quello che volevo, Claude generava il codice, io testavo e segnalavo cosa non funzionava. Non serve sapere Python a memoria — serve sapere cosa vuoi ottenere e saper leggere i risultati.

Non ha funzionato al primo colpo. Ci sono voluti due o tre tentativi per far girare tutto correttamente: il primo problema era nell'estrazione dei frame dal video, il secondo nell'allineamento tra screenshot e testo generato. Ogni volta Claude analizzava l'errore e proponeva una correzione. Il punto è non mollare al primo fallimento — il debug fa parte del processo.

Come Si Usa

Si usa dalla tab Code, non dalla chat normale. Questo è un dettaglio importante: le skill di questo tipo operano nell'ambiente di sviluppo di Claude Code, dove ha accesso al filesystem e può eseguire script. Dalla chat standard non funzionerebbe.

Una volta installata, basta chiamarla con il percorso del video o l'URL e specificare il formato di output. Il resto è automatico: analisi, screenshot, scrittura della documentazione, esportazione.

Cosa Ho Imparato

Costruire tool con Claude Code è una competenza a sé. Non è solo "dare istruzioni all'IA" — è saper strutturare un problema, iterare sul codice, leggere gli errori e guidare il processo verso il risultato. Più lo faccio, più diventa naturale. E ogni skill che costruisco diventa un mattone per la prossima.