Browse Source

Add README.md with installation instructions and skill catalog

softword 1 month ago
parent
commit
51ef0e2343
1 changed files with 64 additions and 0 deletions
  1. 64 0
      README.md

+ 64 - 0
README.md

@@ -0,0 +1,64 @@
+# 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) |