pi-new-project/INSTALL.md

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/:

pi install ./pi-new-project

O desde git/npm cuando se publique:

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 y estará disponible la orden /modelo-proyecto. 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:

mkdir -p ~/.agents/skills
cp -r pi-new-project/skills/new-project ~/.agents/skills/

o enlázalo para mantenerlo actualizado con el repositorio:

ln -s "$PWD/pi-new-project/skills/new-project" ~/.agents/skills/new-project

Rutas equivalentes: ~/.pi/agent/skills/ y, por proyecto, .agents/skills/.

La skill sola no incluye la orden /modelo-proyecto ni la herramienta elegir_modelo_proyecto; cópialas también (o la skill usará el plan B, pi --list-models + --modelo):

mkdir -p ~/.pi/agent/extensions
cp pi-new-project/extensions/modelo-proyecto.ts ~/.pi/agent/extensions/

4. Opción C — exportar a otro ordenador

No hay más que copiar el directorio; no tiene dependencias.

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

Modelo por defecto:

pi-new-project/skills/new-project/scripts/new-project.sh \
  --nombre Demo --modelo anthropic/claude-sonnet-4-5 /tmp/demo2
cat /tmp/demo2/.pi/settings.json

En pi, dentro de /tmp/demo2, /modelo-proyecto debe mostrar el selector de modelos y actualizar .pi/settings.json.

6. Actualización

git pull
pi update --extensions      # si se instaló como paquete

7. Desinstalación

pi remove ./pi-new-project          # si se instaló como paquete
rm -rf ~/.agents/skills/new-project # si se copió o enlazó
rm -f ~/.pi/agent/extensions/modelo-proyecto.ts

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.
El proyecto no arranca con su modelo	Proyecto no confiado: pi ignora .pi/settings.json	Ejecuta /trust en el proyecto.
/modelo-proyecto no existe	Solo se copió la skill	Instala el paquete o copia extensions/modelo-proyecto.ts.
El selector sale vacío	Ningún proveedor con credenciales	/login o configura la API key del proveedor.