# oh-my-skills

Skill per il [Pi Coding Agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent).

## Installazione con `npx skills`

Il CLI [skills](https://github.com/vercel-labs/skills) clona il repo, rileva automaticamente pi
e installa le skill che scegli.

```bash
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git
```

Varianti utili:

```bash
# Elenca le skill disponibili senza installare nulla
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git -l

# Installa solo alcune skill
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git -s commit -s coding-standard-rules

# Installa a livello globale (tutti i progetti) invece che nel progetto corrente
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git -g

# Installa TUTTE le skill senza conferme
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git --all

# Copia i file invece di creare symlink
npx skills add https://gogs.gvoci.com/softword/oh-my-skills.git --copy
```

> ⚠️ Il repository è privato: serve un accesso Git configurato su `gogs.gvoci.com`
> (credenziali salvate o chiave SSH), altrimenti il clone fallisce.

Aggiornamenti e rimozione:

```bash
npx skills update        # aggiorna le skill installate (progetto)
npx skills update -g     # aggiorna solo le skill installate a livello globale
npx skills remove        # rimuove le skill (guidato)
npx skills remove -g     # rimuove le skill installate a livello globale
npx skills ls            # elenca le skill installate
```

## Catalogo delle skill

| Skill | A cosa serve |
|---|---|
| `add-phpengine-plugin` | Crea o modifica plugin PHP per il backend phpengine, seguendo la ricetta ufficiale |
| `ascii-preview-generator` | Anteprime visive ASCII di interfacce, layout e componenti UI |
| `codebase-analysis` | Analizza e documenta l'architettura di un codebase esistente senza modificarlo |
| `code-simplifier` | Semplifica e refattorizza il codice preservandone il comportamento |
| `coding-standard-rules` | Regole di qualità del codice applicate a ogni attività di scrittura/modifica |
| `commit` | Commit atomici in stile Conventional Commits + aggiornamento CHANGELOG |
| `create-docs` | Genera la documentazione strutturata del progetto (AGENTS.md, specs/) |
| `format-report-fix` | Formato standard per riportare le fix con impatto concreto |
| `frontend-mobile-rules` | Regole frontend mobile-first: MUI, viewport e safe-area iOS |
| `gv-brainstorming` | Orchestratore: brainstorming, ispezione, pianificazione, delega e review |
| `refactor-rename` | Rinomina sicura di identificatori su file e cartelle (script incluso, con dry-run) |
| `review-fix-loop` | Ciclo review→fix ripetuto fino a zero violazioni |
| `session-handoff` | Scrive un HANDOFF.md per passare il lavoro a un altro agente o sessione |
| `spec-design-format` | Formato obbligatorio per i design spec in `.spec/` |
| `ssh-manager` | Ispezione di server remoti via plugin MCP ssh-manager (salute, log, DB, processi) |