# Skill para agentes

URL: https://theelena.me/docs/avileo/tiendas/agent-skill
Text: https://theelena.me/docs/avileo/tiendas/agent-skill.txt
Description: Instala la skill oficial para gestionar un catálogo Avileo con un agente confiable.
Context: environment=production; apiBaseUrl=https://tienda.theelena.me; activation=active; rubro=tiendas

# Skill para agentes

La skill `avileo-catalog` enseña a un agente a evaluar y gestionar el perfil,
productos, variantes, categorías, imágenes e inventario con el flujo seguro de
Avileo. También puede revisar una muestra del catálogo y una web confirmada para
dar recomendaciones basadas en evidencia. Usa una Agent Key `avileo_sk_...`
desde un gestor de secretos y sólo funciona cuando el negocio tiene habilitada
la capacidad efectiva de acceso para agentes.

## Instalación

Instalación automática para el host detectado:

```sh
npx skills add leobar37/elena-tech --skill avileo-catalog
```

Para indicar el host explícitamente:

```sh
# Codex
npx skills add leobar37/elena-tech --skill avileo-catalog --agent codex

# Claude Code
npx skills add leobar37/elena-tech --skill avileo-catalog --agent claude-code
```

Agrega `--global` cuando quieras instalarla para todos los proyectos del usuario.
La fuente pública y host-neutral está en
[`leobar37/elena-tech`](https://github.com/leobar37/elena-tech/tree/main/skills/avileo-catalog).

En desarrollo local, la skill conserva un comando o wrapper ya configurado y
usa el SDK del workspace cuando existe un checkout confirmado. La fuente del
paquete y la URL de la API se eligen por separado. La CLI pública está
verificada en npm (`@tarileo/avileo-catalog-cli@0.3.4`); instálala con npx
cuando el host no aporte un comando local y no cambies silenciosamente de
destino.

## Configura la credencial

La conexión requiere un cliente compatible verificado y un despliegue
habilitado. El origen seleccionado para esta guía es https://tienda.theelena.me.
Sin ese cliente, detente en la lectura de documentación: no solicites claves
ni vinculación.

Cuando el cliente esté disponible, el humano deberá autorizar explícitamente
el negocio y los permisos. La Agent Key permanece en el host de confianza;
no la escribas en prompts, argumentos, URLs, archivos JSON, logs ni repositorios.
Una credencial sin origen o con otro destino no autoriza el acceso a esta API.

## Verifica el contexto

Antes de cualquier acceso con un cliente compatible, comprueba que su origen
persistido coincide con el seleccionado; no reenvíes una clave a otro destino.

Continúa únicamente si confirma el negocio, la capacidad efectiva y las acciones
necesarias. Para una evaluación, ejecuta también `business profile show --json`
y revisa una muestra acotada de productos antes de recomendar. Antes de modificar
algo, lee el recurso, ejecuta el preview sin `--apply`, presenta el cambio y
solicita aprobación explícita. Usa `--apply` sólo para crear esa propuesta y
aplica únicamente el identificador aprobado.

Consulta también [Integraciones de agentes](/docs/avileo/tiendas/agent-integration),
[Agent CLI](/docs/avileo/tiendas/agent-cli), [Agent SDK](/docs/avileo/tiendas/agent-sdk) y
[Agent HTTP API](/docs/avileo/tiendas/agent-http).