# Instrucciones para el agente: Printing Press Library: encuentra e instala una CLI para tu agente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/mvanhorn/printing-press-library
- Guía completa: https://lab.wisd.ai/hub/printing-press-library

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba Node.js ≥20 y npm/npx para el instalador del catálogo. Si también instalas skills por la ruta actual de `skills`, comprueba Node.js ≥22.20.0. Antes de instalar una CLI, revisa sus requisitos específicos en su carpeta.

Para instalar el binario, comprueba además Go ≥1.26.10, versión de [.go-version](https://github.com/mvanhorn/printing-press-library/blob/main/.go-version) que exige el [instalador](https://github.com/mvanhorn/printing-press-library/blob/main/npm/README.md#requirements). El instalador compila con go install; si no tienes Go, utiliza la publicación precompilada de la CLI siguiendo su README. Listar y buscar en el catálogo no requieren compilar.

### Paso 1: consulta el catálogo

Con Node y npx disponibles, ejecuta los comandos documentados. Estos comandos consultan el catálogo y no instalan sus CLIs:

```bash
npx -y @mvanhorn/printing-press-library list
npx -y @mvanhorn/printing-press-library search flights --json
```

### Paso 2: revisa una entrada

Abre el README de la herramienta seleccionada. Comprueba plataforma, licencia de su carpeta, credenciales necesarias y qué peticiones o acciones hará. El catálogo no tiene un único método de autenticación.

### Paso 3: instala solo la herramienta que necesitas

Este es el ejemplo del README para ESPN. Ejecútalo solo si esa es la herramienta elegida:

```bash
npx -y @mvanhorn/printing-press-library install espn
```

Esta ruta instala ambos y requiere Node.js ≥22.20.0. El binario se llama `espn-pp-cli`: añade `~/.local/bin` a PATH en macOS/Linux o `%LOCALAPPDATA%\Programs\PrintingPress\bin` en Windows. El instalador añade binario y skill. El README explica cómo usar cli-only o skill-only cuando necesitas una sola pieza; consulta después la guía de la CLI elegida para su acceso y uso.

## Comprobación

Consulta el inventario de instalaciones:

```bash
npx -y @mvanhorn/printing-press-library list --installed
```

Comprueba que aparece la entrada prevista y que el agente ve su skill. La instalación no verifica por sí misma los permisos sobre el servicio remoto: sigue el diagnóstico específico de esa herramienta y comienza por una lectura.

## Si algo falla

Distingue problemas del instalador y problemas de la CLI instalada. Revisa el PATH para el binario y el arnés destinatario para la skill; comprueba los permisos o tokens en la documentación del servicio. No confundas el instalador printing-press-library con el generador cli-printing-press. Consulta el [README del catálogo](https://github.com/mvanhorn/printing-press-library/blob/main/README.md).