# Instrucciones para el agente: Hallmark: diseña y audita páginas con una dirección visual

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: principiante
- Proyecto: https://github.com/Nutlope/hallmark (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/hallmark-design-skill

---

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

### Paso 1: instala

Comprueba Node.js ≥22.20.0 y npm/npx. Aunque Hallmark indica ≥18, la vía `npx skills` ejecuta un [instalador con mínimo ≥22.20.0](https://github.com/vercel-labs/skills/blob/main/package.json). Para la revisión visual, comprueba también Chrome y prepara la dependencia que pide el README:

```bash
npm i -g puppeteer-core
```

```bash
npx skills add nutlope/hallmark -g
```

### Paso 2: prueba una auditoría

En Claude Code, el README muestra:

```text
/hallmark audit ./index.html
```

Usa la ruta real de tu página. Para modificar una interfaz existente, revisa primero el modo de rediseño del README.

## Comprobación

El agente debe producir hallazgos sobre la página indicada y distinguir problemas básicos de acabado. Abre la página y contrasta los hallazgos con una prueba móvil y de teclado.

## Si algo falla

Si no se reconoce la orden, comprueba que la skill se cargó en el arnés elegido. Si el agente no puede abrir el navegador o la URL, resuelve ese acceso antes de aceptar la auditoría.