feat: paquete pi-new-project con la skill new-project

INSTALL.md

@@ -0,0 +1,102 @@
+# INSTALL — pi-new-project
+
+Instalación del paquete/skill `new-project` en pi, en este ordenador o en
+cualquier otro.
+
+## 1. Requisitos
+
+| Componente | Versión mínima | Notas |
+| --- | --- | --- |
+| pi | 1.3.0 | Hace falta soporte de skills y de paquetes (`pi install`). |
+| bash | 4.0 | El script usa arrays y `${var//}`. |
+| git | cualquiera | Opcional: `--git` y autor por defecto. |
+| shellcheck | opcional | Para validar el script (`shellcheck new-project.sh`). |
+
+## 2. Opción A — instalarlo como paquete de pi (recomendado)
+
+Desde el directorio que contiene `pi-new-project/`:
+
+```bash
+pi install ./pi-new-project
+```
+
+O desde git/npm cuando se publique:
+
+```bash
+pi install git:github.com/<usuario>/pi-new-project@v0.1.0
+```
+
+Comprueba con `pi list` y arranca pi: la skill aparecerá como `new-project`.
+Para una prueba puntual sin instalarlo: `pi -e ./pi-new-project`.
+
+## 3. Opción B — copiar la skill
+
+Copia el directorio de la skill a una de las rutas que pi descubre:
+
+```bash
+mkdir -p ~/.agents/skills
+cp -r pi-new-project/skills/new-project ~/.agents/skills/
+```
+
+o enlázalo para mantenerlo actualizado con el repositorio:
+
+```bash
+ln -s "$PWD/pi-new-project/skills/new-project" ~/.agents/skills/new-project
+```
+
+Rutas equivalentes: `~/.pi/agent/skills/` y, por proyecto, `.agents/skills/`.
+
+## 4. Opción C — exportar a otro ordenador
+
+No hay más que copiar el directorio; no tiene dependencias.
+
+```bash
+# en el ordenador origen
+tar -czf pi-new-project-0.1.0.tar.gz pi-new-project/
+
+# en el ordenador destino
+tar -xzf pi-new-project-0.1.0.tar.gz
+pi install ./pi-new-project        # o la opción B
+```
+
+Alternativa sin `tar`: publicar el repositorio y usar `pi install <url-de-git>`.
+
+## 5. Verificación
+
+```bash
+bash -n pi-new-project/skills/new-project/scripts/new-project.sh
+pi-new-project/skills/new-project/scripts/new-project.sh --dry-run --nombre Demo /tmp/demo
+
+# prueba real en un directorio temporal
+pi-new-project/skills/new-project/scripts/new-project.sh \
+  --nombre Demo --descripcion "Proyecto de prueba" --git /tmp/demo
+ls -A /tmp/demo
+```
+
+Deben aparecer `AGENTS.md`, `README.md`, `CHANGELOG.md`, `TODO.md`, `INSTALL.md`
+y `.gitignore`, sin marcadores `{{...}}` pendientes.
+
+## 6. Actualización
+
+```bash
+git pull
+pi update --extensions      # si se instaló como paquete
+```
+
+## 7. Desinstalación
+
+```bash
+pi remove ./pi-new-project          # si se instaló como paquete
+rm -rf ~/.agents/skills/new-project # si se copió o enlazó
+```
+
+La skill no deja estado propio: no hay caché ni configuración que limpiar.
+
+## 8. Resolución de problemas
+
+| Síntoma | Causa probable | Solución |
+| --- | --- | --- |
+| La skill no aparece | Ruta no descubierta | Comprueba la ruta con `pi list` o colócala en `~/.agents/skills/`. |
+| `no encuentro las plantillas` | Falta `templates/` | Reinstala el paquete completo, no solo el script. |
+| `no puedo deducir el nombre` | Destino `.` o `/` | Pasa `--nombre`. |
+| No sobreescribe mis ficheros | Protección por defecto | Usa `--force` tras revisar `--dry-run`. |