> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills para editores de IA

> El CLI de Jelou instala skills (paquetes de capacidades en markdown) en tus editores de IA para que un agente sepa operar la plataforma. Instálalas, actualízalas y gestiona sus versiones.

El CLI de Jelou es **agente-nativo**: además de ejecutarse desde la terminal,
empaqueta **skills** — paquetes de capacidades en markdown — que se instalan en
tus editores de IA. Una vez instaladas, un agente (Claude Code, Cursor, Codex,
Windsurf, etc.) sabe qué comandos `jelou` existen, qué hace cada área de
producto y cómo encadenarlos, así que puedes pedirle en lenguaje natural
*"despliega esta función"* o *"construye un flujo de soporte"* y elige el
comando correcto.

## Cómo funcionan

* En tu **primer `jelou login` exitoso**, el CLI detecta los editores de IA
  instalados y les instala las skills globalmente. Las sesiones nuevas en esos
  editores ya conocen `jelou`.
* Cada skill se escribe como markdown bajo un directorio de skills del editor.
  El CLI escribe una copia canónica en `<root>/.agents/skills/<skill>/` y luego
  crea symlinks (o copias, en sistemas que bloquean symlinks) hacia el
  directorio de cada agente detectado.
* Todas las skills derivan su versión de la versión del binario del CLI: cuando
  actualizas `jelou`, todas las skills se reportan como actualizadas.

<Note>
  "Skill" aquí significa el **paquete markdown** que `jelou agent install` escribe
  en los editores de IA. No lo confundas con el sentido legacy de "skill" como
  *workflow* dentro de un proyecto.
</Note>

## `jelou agent install`

Instala (o reinstala) las skills manualmente. En una terminal interactiva
pregunta por agentes destino, alcance, método de instalación y confirmación. En
CI, modo JSON, modo agente o con stdout redirigido nunca pregunta.

```bash theme={null}
jelou agent install                                              # interactivo
jelou agent install --global --targets codex --yes --no-input    # un agente
jelou agent install --global --all-targets --yes --no-input      # todos
jelou agent install --global --only project,whatsapp --targets codex,claude
```

| Flag                       | Descripción                                                                          |
| -------------------------- | ------------------------------------------------------------------------------------ |
| `--global`                 | Instala en el home del usuario (todos los proyectos) en vez de en el proyecto actual |
| `--targets <a,b>`          | Lista de agentes destino específicos                                                 |
| `--all-targets`            | Instala en todos los agentes detectados                                              |
| `--only <s1,s2>`           | Instala solo las skills indicadas                                                    |
| `--method <symlink\|copy>` | Método de instalación (`symlink` por defecto: una sola fuente de verdad)             |
| `--api`                    | Instala la variante del SDK enfocada en API cuando está disponible (solo Functions)  |
| `--yes`                    | Omite la confirmación (para CI/no interactivo)                                       |

### Editores de IA soportados

El CLI detecta y soporta estos destinos:

| Universal (`.agents/skills`)                                    | Específicos                                                                                    |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Amp, Codex, Gemini CLI, GitHub Copilot, OpenCode, Kimi Code CLI | Claude Code (`.claude/skills`), Cursor (`.cursor/skills`), Windsurf, Cline, Continue, Roo Code |

## `jelou skills`

Inspecciona y gestiona las versiones de las skills instaladas.

```bash theme={null}
jelou skills list                          # skills empaquetadas vs. instaladas
jelou skills check --skill jelou-functions # detecta si una skill está desactualizada
jelou skills acknowledge --skill jelou-functions   # marca su versión como vista
jelou skills ack-update --version 1.53.0   # descarta el aviso de update del CLI
```

| Subcomando                   | Descripción                                                                                           |
| ---------------------------- | ----------------------------------------------------------------------------------------------------- |
| `list`                       | Lista todas las skills con su versión empaquetada e instalada                                         |
| `check --skill <name>`       | Detecta drift y emite marcadores de versión (`CLI_OUTDATED`, `CLI_UPDATE_AVAILABLE`, `SKILL_UPDATED`) |
| `acknowledge --skill <name>` | Marca la versión de una skill como vista; limpia el flag `SKILL_UPDATED`                              |
| `ack-update --version <v>`   | Descarta el aviso `CLI_UPDATE_AVAILABLE` para esa versión                                             |

## Skills disponibles

El CLI empaqueta estas skills (varias incluyen variantes y archivos de
referencia adicionales):

| Skill                      | Cubre                                                                                                      |
| -------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `jelou`                    | Instalación, auth, perfiles, modos de salida y navegación del CLI                                          |
| `jelou-functions`          | Funciones serverless (variantes `cli` y `api`)                                                             |
| `jelou-databases`          | Bases de datos gestionadas (alias `jelou-datum`)                                                           |
| `jelou-project`            | Proyectos, archivos de conocimiento y canales                                                              |
| `jelou-whatsapp`           | Bots, plantillas y campañas de WhatsApp                                                                    |
| `jelou-shop`               | Catálogo, productos, pedidos y cupones de Jelou Shop (ecommerce)                                           |
| `jelou-debug-conversation` | Triaje de conversaciones de producción (logs)                                                              |
| `jelou-insights`           | Analítica de conversaciones: preguntas frecuentes, fricción, sentimiento y oportunidades de automatización |
| `jelou-feedback`           | Enviar reportes desde el CLI                                                                               |

Además, los **bundles BrainOps** son paquetes instalables más completos (con
ejecutables, referencias y hooks) para construir y probar workflows:
`jelou-build-workflows` (construcción de workflows), `jelou-test-workflow`
(QA de un workflow) y `jelou-audit-workflows` (auditorías read-only).

## Mantener las skills al día

Tras actualizar el CLI, refresca las skills instaladas para que las sesiones
nuevas vean los cambios:

```bash theme={null}
npm install -g @jelou/cli@latest
jelou --version
jelou agent install --global --all-targets --yes --no-input
```

<Tip>
  Si un agente no parece conocer `jelou`, ejecuta
  `jelou agent install --global` y abre una **sesión nueva** del editor — las
  skills se cargan al inicio de la sesión.
</Tip>
