Guida all'uso

Come usare
ATS CV Optimize

Installazione, prompt pronti da copiare, tre esempi reali e i limiti da conoscere prima di iniziare. Tutto quello che serve per rifare il CV una volta sola e farlo bene.

01 · Installazione

Tre passaggi, due minuti.

La skill funziona su claude.ai, Claude Code e Claude Cowork. Il percorso più semplice è lo .zip acquistato; se preferisci, il repository pubblico su GitHub contiene esattamente lo stesso codice.

1
Scarica e scompatta lo .zip
Dopo l'acquisto trovi il link di download nella pagina di conferma. Dentro c'è la cartella ats-cv-optimize con la skill, i file di riferimento, il renderer e gli esempi.
2
Caricala su Claude
Su claude.ai: impostazioni → skill → carica la cartella come skill personalizzata. Su Claude Code: copia la cartella in ~/.claude/skills/ (per tutti i progetti) oppure in .claude/skills/ dentro un singolo progetto.
3
Installa python-docx (solo per il DOCX)
Serve a generare il file Word finale: pip3 install python-docx. Senza, la skill produce comunque il CV in Markdown e in JSON, semplicemente non genera il .docx. Consiglio: non creare il PDF, perché è un formato non letto correttamente dai parser ATS.
4
Scrivi in italiano, e basta
Non c'è nessun comando da imparare. La skill si attiva da sola quando parli di curriculum, anche se non nomini mai la parola «ATS».

In alternativa, da GitHub

Il codice è pubblico con licenza MIT e installarlo da GitHub è gratis. Lascia l'email e ti mostro i comandi e il link al repository.

git clone https://github.com/gioenjoy/ats-cv-optimize.git
cp -r ats-cv-optimize/skills/ats-cv-optimize ~/.claude/skills/
pip3 install python-docx

Oppure, come plugin: /plugin marketplace add gioenjoy/ats-cv-optimize e poi /plugin install ats-cv-optimize. Repository: github.com/gioenjoy/ats-cv-optimize

Sblocca i comandi di installazione
02 · Prompt pronti

Copia, incolla, allega il CV.

Non serve una formula magica: la skill riconosce l'intenzione. Questi sono i punti di partenza che coprono quasi tutti i casi. Se hai il CV, allegalo (PDF, DOCX, foto o testo incollato). Se hai l'annuncio, incollalo per intero.

“Sistemami il curriculum per questo annuncio: <incolla qui il testo dell'annuncio>
“Ho un CV in Europass, me lo converti? Dimmi anche quando mi conviene tenere l'originale.
“Il mio CV non passa mai gli screening, dammi un'occhiata: cosa non va?
“Scrivimi un CV da zero, sono perito meccanico con 4 anni in officina.
“Ottimizza il curriculum per le candidature su InfoJobs e LinkedIn.
“Dimmi quali requisiti di questo annuncio il mio profilo non copre, senza addolcire.
“Fammi il CV e anche la lettera di presentazione per questa posizione.

Se non hai né CV né annuncio, scrivi semplicemente «aiutami a fare il curriculum»: la skill ti fa le domande giuste, massimo tre per volta, e non chiede ciò che può già dedurre.

03 · Esempi reali

Tre momenti in cui ti ferma.

La skill non riscrive in silenzio. Ogni volta che tocca qualcosa di importante te lo mostra, spiega il perché e aspetta la tua decisione. Ecco i tre casi che incontrerai di sicuro.

Esempio 1 · La frase fatta
Claude · ATS CV Optimize
TU
Nel profilo ho scritto «Professionista dinamico e orientato al risultato, con ottime capacità relazionali».
Tre voci in blacklist in una riga sola. Il punto non è che siano false: è che non sono verificabili, quindi il selezionatore le salta e il parser non ci trova nessuna keyword da indicizzare.

✗ Professionista dinamico e orientato al risultato, con ottime capacità relazionali
✓ Responsabile commerciale con 6 anni nel canale HoReCa, portafoglio di 80 clienti diretti nel Nord-Est

La seconda versione dice le stesse cose — sei sveglio, lavori con le persone, porti risultati — ma le dimostra invece di dichiararle. Procedo così o preferisci un'altra formulazione?
Esempio 2 · Il numero che manca
Claude · ATS CV Optimize
TU
Ho migliorato il processo di magazzino, mettici tu una percentuale che suona bene.
Questo non lo faccio: un numero inventato sul CV diventa un problema al colloquio, quando qualcuno ti chiede come l'hai misurato.

Due strade. Se il dato ce l'hai anche approssimativo — quanti giorni di giacenza prima e dopo, quanti errori di picking in meno — lo usiamo. Se non ce l'hai, scriviamo il bullet con una dimensione concreta al posto della metrica:
  • Riorganizzato il flusso di picking su un magazzino di 4.000 referenze, introducendo la mappatura per rotazione
È già molto più forte di «migliorato il processo», e regge a qualsiasi domanda.
Esempio 3 · L'Europass
Claude · ATS CV Optimize
TU
Ti allego il mio CV. Uso l'Europass da sempre.
Il tuo CV è in formato Europass. Va benissimo per i concorsi pubblici e per alcuni bandi europei, dove spesso è richiesto espressamente: in quel caso tienilo così.

Per le candidature ad aziende private è però il formato che gli ATS leggono peggio, perché è costruito su tabelle e colonne che il parser spezza. Ti preparo una versione ATS-safe per le candidature aziendali, e tieni l'Europass per i bandi che lo richiedono.

Intanto ho estratto i tuoi dati: controlla che sia tutto corretto prima che vada avanti.
04 · Cosa ricevi

Due file e una lista di lacune.

Alla fine del flusso la skill consegna un Markdown modificabile (per continuare a lavorarci) e un DOCX ATS-safe generato da render_docx.py, non scritto dal modello. Più l'elenco dei requisiti dell'annuncio che il tuo profilo non copre: serve a sapere dove sei scoperto prima che te lo dica qualcun altro.

Il renderer, se vuoi usarlo a mano

python3 scripts/render_docx.py --input cv.json --check
python3 scripts/render_docx.py --input cv.json --output Nome_Cognome_CV.docx

Il validatore blocca la generazione quando trova bullet in prima persona o passivi, participi accordati al femminile o al plurale in apertura, emoji, barre di valutazione o quello che sembra un codice fiscale. Segnala invece come semplice avviso le date fuori formato, lo stesso verbo che apre più bullet nello stesso ruolo, i livelli di lingua non QCER e l'indirizzo completo al posto della città.

05 · Limiti onesti

Cosa la skill non fa.

  • !Non inventa. Nessun numero, strumento, ruolo o certificazione che tu non abbia dichiarato. Se insisti per un dato inventato, ti dice di no e ti propone l'alternativa concreta.
  • !Non ti sostituisce. Ogni segnalazione è una proposta: puoi sempre imporre la tua versione. La skill avvisa una volta e poi si adegua, senza ripetere l'avviso a ogni passaggio.
  • !Non fa CV in altre lingue. Per la versione inglese ti propone di farla a parte, perché non è una traduzione parola per parola: cambiano struttura, titoli di studio e convenzioni.
  • !Non garantisce nulla. Un CV leggibile dall'ATS arriva al selezionatore. Quello che succede dopo dipende dal contenuto, dal mercato e dalla posizione.
  • !Non è consulenza legale. Il materiale su privacy, titoli di studio e prassi di selezione descrive gli usi correnti del mercato del lavoro italiano.
  • !Senza Python niente DOCX. Su un ambiente senza python-docx ricevi comunque Markdown e JSON, ma l'impaginazione finale la fai tu.

Pronto a rifare il CV per bene?

7€ una tantum per lo .zip già pronto e questa guida. Il codice resta aperto su GitHub, con licenza MIT.

Acquista la skill →