Aggiungi la scheda di project-estimation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

README.md

@@ -8,3 +8,4 @@ Il mio dizionario delle skill per agenti AI (Claude Code, Codex, app di Claude e
 |---|---|
 | [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). |

skills/project-estimation.md

@@ -0,0 +1,143 @@
+# project-estimation
+
+- **Autore:** aj-geddes
+- **Repository:** [aj-geddes/useful-ai-prompts](https://github.com/aj-geddes/useful-ai-prompts) (licenza MIT), una raccolta di oltre 260 skill e 488 prompt
+- **Sorgente:** [skills/project-estimation/SKILL.md](https://github.com/aj-geddes/useful-ai-prompts/blob/main/skills/project-estimation/SKILL.md)
+- **Pagina su skills.sh:** [aj-geddes/useful-ai-prompts/project-estimation](https://skills.sh/aj-geddes/useful-ai-prompts/project-estimation)
+- **Diffusione (settembre 2026):** circa 645 installazioni (su skills.sh dal 21 gennaio 2026); il repository ha circa 344 stelle su GitHub
+- **Controlli di sicurezza su skills.sh:** Gen Agent Trust Hub, Socket e Snyk superati
+
+> Esiste un'altra skill con lo stesso nome, di [szkocot/skills](https://github.com/szkocot/skills): stima software per ruolo con esportazione in Excel e Jira, ma con 4 installazioni e il controllo Snyk non superato. Questa scheda riguarda solo la versione di aj-geddes.
+
+## A cosa serve
+
+Aiuta l'agente a stimare durata, costi e risorse di un progetto con tecniche strutturate, invece di dare numeri "a occhio". L'obiettivo è arrivare a tempi, budget e allocazione del team realistici, combinando dati storici, giudizio esperto e metodi di stima.
+
+## Cosa fa
+
+### Quando si attiva
+
+Quando devi:
+
+- definire ambito e deliverable di un progetto;
+- preparare budget e tempistiche;
+- assegnare le risorse del team;
+- gestire le aspettative degli stakeholder;
+- valutare se un progetto è fattibile;
+- pianificare margini per gli imprevisti;
+- aggiornare le stime a progetto in corso.
+
+### Come lavora
+
+La skill è una guida di metodo: fornisce all'agente le tecniche e le regole, non un flusso a passi fissi. Le tecniche, ognuna con una guida dedicata nella cartella `references/`:
+
+| Tecnica | Idea | Guida |
+|---|---|---|
+| Stima a tre punti (PERT) | per ogni attività si stimano scenario ottimista, più probabile e pessimista, poi si calcola una media pesata | `three-point-estimation-pert.md` |
+| Bottom-up | si scompone il lavoro in attività piccole, si stimano una per una e si sommano | `bottom-up-estimation.md` |
+| Per analogia | si parte da progetti simili già conclusi | `analogous-estimation.md` |
+| Stima delle risorse | quante persone, con quali ruoli e per quanto tempo | `resource-estimation.md` |
+| Template | modelli pronti per presentare le stime | `estimation-templates.md` |
+
+La skill include anche una cartella `templates/`.
+
+**Esempio incluso (Python):** una classe `ThreePointEstimation` che calcola:
+
+- la stima PERT: `(O + 4M + P) / 6`, dove O è ottimista, M più probabile e P pessimista;
+- la deviazione standard: `(P − O) / 6`;
+- l'intervallo di confidenza al 95% (z = 1,96) o al 99% (z = 2,576).
+
+Per esempio, con O = 10, M = 15 e P = 26 giorni, la stima PERT è 16 giorni, la deviazione standard circa 2,7 giorni e l'intervallo al 95% va da circa 10,8 a 21,2 giorni.
+
+### Regole che segue
+
+**Da fare:**
+
+- usare più tecniche e confrontarne i risultati;
+- aggiungere un margine per gli imprevisti (15-25% per i progetti nuovi);
+- basarsi sui dati storici di progetti simili;
+- scomporre i lavori grandi in parti più piccole;
+- coinvolgere chi farà davvero il lavoro;
+- documentare chiaramente ipotesi ed esclusioni;
+- rivedere le stime regolarmente e confrontarle con i tempi reali;
+- includere le attività non di sviluppo (pianificazione, test, rilascio);
+- considerare il tempo di apprendimento delle tecnologie nuove.
+
+**Da evitare:**
+
+- stimare senza un ambito chiaro;
+- usare scenari ottimistici irrealistici;
+- stimare sotto pressione per rispettare obiettivi arbitrari;
+- usare le stime per valutare le prestazioni delle singole persone;
+- cambiare le stime a metà progetto senza un motivo chiaro;
+- stimare senza il parere del team;
+- ignorare rischi e margini;
+- usare una sola tecnica.
+
+### Da sapere
+
+- È una guida generica di project management: non legge il codice del progetto e non produce file o task da sola. La qualità della stima dipende da quante informazioni dai all'agente (ambito, team, dati di progetti passati).
+- Contiene solo istruzioni, guide ed esempi di codice, senza script da eseguire all'installazione, quindi funziona anche nelle app di chat.
+
+## Installazione
+
+### Claude Code e Codex
+
+```bash
+npx skills add aj-geddes/useful-ai-prompts --skill project-estimation -g -a claude-code -a codex
+```
+
+| Opzione | Significato |
+|---|---|
+| `--skill project-estimation` | installa solo questa skill; senza, lo strumento propone tutte le oltre 260 skill del repository |
+| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente (`.claude/skills/`, `.agents/skills/`) |
+| `-a <agente>` | agente di destinazione, ripetibile |
+| `-y` | salta le domande di conferma |
+| `--copy` | copia i file invece di creare collegamenti simbolici |
+
+Per un solo agente, lascia un solo `-a`. Dopo l'installazione riavvia la sessione. In Codex puoi richiamarla con `$project-estimation` o vederla con `/skills`; Claude Code la usa da solo quando chiedi una stima.
+
+Gestione:
+
+```bash
+npx skills list -g                     # skill installate
+npx skills update project-estimation   # aggiornamento
+npx skills remove project-estimation   # rimozione
+```
+
+Il README del repository non documenta metodi di installazione propri (plugin o marketplace).
+
+### App desktop di Claude e ChatGPT
+
+Prepara lo ZIP con la cartella della skill:
+
+```bash
+git clone --depth 1 https://github.com/aj-geddes/useful-ai-prompts.git
+cd useful-ai-prompts/skills && zip -r ~/project-estimation.zip project-estimation
+```
+
+Lo ZIP deve contenere la cartella `project-estimation/` con dentro `SKILL.md`, `references/` e `templates/`.
+
+**Claude (desktop o web)**
+
+1. Attiva l'esecuzione del codice in **Settings → Capabilities**.
+2. Vai in **Customize → Skills → + → Create skill → Upload a skill** e scegli lo ZIP.
+3. Attiva l'interruttore della skill.
+
+**ChatGPT (desktop o web)**
+
+1. Vai in **Skills** nella barra laterale, poi **Create → Upload from your computer**, e scegli lo ZIP o la cartella.
+2. Attendi l'analisi di sicurezza di ChatGPT.
+3. Richiamala con `@` nella chat.
+
+Le skill caricate su desktop e web non si sincronizzano: vanno caricate su ciascuna.
+
+## Fonti
+
+- [README di aj-geddes/useful-ai-prompts](https://github.com/aj-geddes/useful-ai-prompts)
+- [SKILL.md di project-estimation](https://github.com/aj-geddes/useful-ai-prompts/blob/main/skills/project-estimation/SKILL.md)
+- [project-estimation su skills.sh](https://skills.sh/aj-geddes/useful-ai-prompts/project-estimation)
+- [project-estimation di szkocot su skills.sh](https://skills.sh/szkocot/skills/project-estimation) (l'altra skill con lo stesso nome)
+- [README di vercel-labs/skills](https://github.com/vercel-labs/skills)
+- [Use skills in Claude – Claude Help Center](https://support.claude.com/en/articles/12512180-use-skills-in-claude)
+- [Skills in ChatGPT – OpenAI Help Center](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)