# Instrucciones para el agente: Shopify Admin Skills: prepara operaciones de tienda con 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/40RTY-ai/shopify-admin-skills (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/shopify-admin-skills

---

## 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 ≥22.20.0 y npm/npx para el instalador skills. Abre la carpeta del proyecto y confirma que el arnés elegido admite skills antes de instalar.

### Paso 1: instala las instrucciones

El README publica:

```bash
npx skills add 40RTY-ai/shopify-admin-skills
```

### Paso 2: elige una tarea

Lee, por ejemplo, `shopify-admin-order-lookup-and-summary`. Declara `read_orders` y `read_customers`, el dominio de tienda y consulta por número de pedido. Hay una limitación documental: cita `shopify auth login --store <domain>` y los toolkits `shopify-admin`/`shopify-admin-execution`, pero el repositorio no proporciona en esa skill un servidor ejecutable ni un recorrido completo para obtener el token de Admin API. Antes de usarla debes tener un conector Admin GraphQL operativo en tu arnés para la tienda de ensayo; iniciar sesión en una CLI de desarrollo no demuestra ese acceso. Si no lo tienes, detén aquí la prueba y resuelve el conector con su documentación oficial. Empieza por una consulta de pedidos o inventario, sin activar rutinas ni operaciones de escritura.

### Paso 3: prueba una consulta

Con el conector ya disponible, pide «Usa order-lookup-and-summary en mi tienda de ensayo para consultar el pedido #1001, sin modificarlo; muestra tienda, importe, estado y enlace». Sustituye #1001 por un pedido existente y compara esos campos en Shopify Admin. Si falta la herramienta, no presentes una respuesta del modelo como resultado de la consulta.

## Comprobación

Comprueba los datos contra Shopify Admin y confirma que el acceso tiene el alcance previsto. Antes de programar una rutina, revisa su frecuencia, destino y capacidad de escritura.

## Si algo falla

Si faltan datos, revisa los permisos y la conexión de Shopify. Si la skill no encuentra una herramienta, consulta sus requisitos: la instalación de Markdown no incluye automáticamente un servidor MCP.

Consulta el [README oficial](https://github.com/40RTY-ai/shopify-admin-skills#readme) para el procedimiento completo y los cambios de versión.