# Instrucciones para el agente: Guizang: convierte contenido en tarjetas sociales

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/op7418/guizang-social-card-skill (licencia AGPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/guizang-social-card-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: prepara el entorno

Comprueba que el agente puede escribir archivos y ejecutar comandos, y que tienes Node.js ≥22.20.0 con npm/npx para instalar la skill, según el [manifiesto del instalador](https://github.com/vercel-labs/skills/blob/main/package.json). Para exportar las tarjetas, prepara un navegador controlado por Playwright o un flujo equivalente de capturas siguiendo [Production Workflow](https://github.com/op7418/guizang-social-card-skill/blob/main/references/production-workflow.md#rendering). Esa referencia no fija versiones mínimas. Trabaja en una carpeta de tarea, por defecto `local-tests/<slug>/`, y reserva `output/` para los PNG.

### Paso 2: sigue la instalación oficial

```bash
npx skills add https://github.com/op7418/guizang-social-card-skill --skill guizang-social-card-skill
```

## Comprobación

Pide al agente una tarjeta estática a partir de un texto propio, indicando plataforma y proporción. Sigue SKILL.md para renderizar y validar; revisa los PNG exportados y comprueba que no haya recortes o texto ilegible.

## Si algo falla

Si aparecen desbordamientos, revisa las mediciones del validador y reduce el contenido antes de bajar el tamaño de letra. Consulta README.en.md para la instalación y el flujo en inglés.

[Fuente de los comandos y del procedimiento](https://github.com/op7418/guizang-social-card-skill#readme).