# 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 (ottobre 2026):** circa 649 installazioni (su skills.sh dal 21 gennaio 2026); il repository ha circa 363 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)