- **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
- **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.
