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

# Codear con IA

> Instala el flujo de Jelou Functions en tu herramienta de IA para que entienda el API define(), los comandos del CLI y las convenciones de la plataforma.

Con `jelou skill install` instalas un archivo `SKILL.md` en tu herramienta de codificación con IA. Este archivo le enseña todo sobre Jelou Functions: el API `define()`, el objeto `ctx`, validación con Zod, cron, testing y los comandos del CLI. Con esto, tu herramienta puede escribir código correcto para la plataforma desde el primer prompt.

## Instalación

<Steps>
  <Step title="Ejecuta el instalador">
    Desde la raíz de tu proyecto de Jelou Functions:

    ```bash theme={null}
    jelou skill install
    ```
  </Step>

  <Step title="Verifica la salida">
    El CLI detecta automáticamente qué herramientas tienes instaladas:

    ```bash theme={null}
    ✓ Installed jelou-functions skill for 4 agents

    ▸ Claude Code
    ▸ Cursor
    ▸ Windsurf
    ▸ Cline

    Installed locally — commit .agents/ to share with your team.
    ```
  </Step>

  <Step title="Abre tu herramienta y empieza a codear">
    El flujo se activa automáticamente cuando la herramienta detecta código relacionado con Jelou Functions (`define()`, `@jelou/functions`, `ctx.env`, etc.).
  </Step>
</Steps>

## Herramientas soportadas

El instalador detecta 12 herramientas de codificación con IA. Cada una usa su propio directorio de workflows, pero todas reciben el mismo contenido.

<Tabs>
  <Tab title="Claude Code">
    **Directorio:** `.claude/skills/jelou-functions/SKILL.md`

    Se detecta automáticamente. El flujo aparece como contexto disponible en tus conversaciones.
  </Tab>

  <Tab title="Cursor">
    **Directorio:** `.cursor/skills/jelou-functions/SKILL.md`

    Se detecta automáticamente. Cursor carga el flujo cuando trabajas en archivos de Jelou Functions.
  </Tab>

  <Tab title="Windsurf">
    **Directorio:** `.windsurf/skills/jelou-functions/SKILL.md`

    Se detecta automáticamente al abrir el proyecto.
  </Tab>

  <Tab title="Universales">
    **Directorio compartido:** `.agents/skills/jelou-functions/SKILL.md`

    Las siguientes herramientas leen del directorio universal `.agents/skills/`:

    | Herramienta    | Detección                                |
    | -------------- | ---------------------------------------- |
    | Amp            | `~/.config/amp`                          |
    | Codex          | `~/.codex`                               |
    | Gemini CLI     | `~/.gemini`                              |
    | GitHub Copilot | `.github/` en el proyecto o `~/.copilot` |
    | OpenCode       | `~/.config/opencode`                     |
    | Kimi Code CLI  | `~/.kimi`                                |
  </Tab>

  <Tab title="Otras">
    Las siguientes herramientas tienen su propio directorio de workflows:

    | Herramienta | Directorio          |
    | ----------- | ------------------- |
    | Cline       | `.cline/skills/`    |
    | Continue    | `.continue/skills/` |
    | Roo Code    | `.roo/skills/`      |

    El instalador crea un symlink desde cada directorio hacia la copia canónica en `.agents/skills/`.
  </Tab>
</Tabs>

## Cómo usarlo

Una vez instalado, tu herramienta de IA entiende la plataforma completa. Prueba con prompts como:

```
Crea una función que consulte el saldo de un cliente por teléfono
```

```
Agrega validación Zod al input con .describe() para que el MCP tenga buenas descripciones
```

```
Configura un cron que se ejecute cada hora para limpiar registros viejos
```

```
Escribe tests con createMockContext para la función de consulta de clientes
```

El flujo se activa automáticamente cuando la herramienta detecta patrones como `define()`, `@jelou/functions`, `ctx.env`, `ctx.isCron`, `createMockContext`, o comandos `jelou`.

## Local vs global

| Modo   | Comando                        | Ubicación                      | Uso                                          |
| ------ | ------------------------------ | ------------------------------ | -------------------------------------------- |
| Local  | `jelou skill install`          | `.agents/skills/` del proyecto | Por proyecto, comparte con el equipo via git |
| Global | `jelou skill install --global` | Directorio home (`~`)          | Activo en todos los proyectos                |

**Local** es ideal para equipos: al hacer commit de `.agents/skills/`, cualquier miembro que clone el repo tendrá el flujo disponible sin ejecutar nada.

**Global** es útil si trabajas en múltiples proyectos de Jelou Functions y quieres el flujo siempre activo.

<Tip>
  Haz commit de `.agents/skills/` en tu repositorio para que todo tu equipo tenga el flujo automáticamente al clonar el proyecto.
</Tip>