agents_and_robots/.claude/skills/create-bot/SKILL.md

---
name: create-bot
description: >
  Crear un nuevo robot Matrix (command-only, sin LLM). Ejecuta el pipeline
  scaffold + build + register + verify + convert + notify, luego personaliza
  comandos custom segun los inputs del usuario.
allowed-tools: Bash Read Write Edit Grep Glob Agent
argument-hint: "<bot-id> [display-name]"
---

# Crear robot Matrix

Skill para crear un robot Matrix ligero (command-only, sin LLM).
Un robot solo responde a comandos — no tiene reglas, memoria, tools ni system prompt.

## Inputs requeridos

Recoger del usuario (preguntar lo que falte):

| Input | Requerido | Default | Ejemplo |
|-------|-----------|---------|---------|
| `bot-id` | si | — | `ping-bot` |
| `display-name` | si | bot-id | `"Ping Bot"` |
| `description` | si | — | `"Bot de monitoreo con ping"` |
| Comandos custom | no | ninguno | `!status`, `!deploy <env>` |

Si `$ARGUMENTS` contiene el bot-id, usarlo directamente: `$0` = bot-id, `$1` = display-name.

## Proceso completo

### Paso 1: Validar inputs

1. Verificar que `bot-id` es kebab-case (lowercase, letras, numeros, guiones)
2. Verificar que no existe `agents/<bot-id>/`
3. Si faltan inputs, preguntar al usuario

### Paso 2: Ejecutar pipeline completo

```bash
./dev-scripts/agent/create-full.sh <bot-id> "<display-name>" --type robot
```

Este script ejecuta 6 etapas automaticamente:
1. **Scaffold**: crea agent.go, config.yaml, prompts/ desde template
2. **Build**: verifica compilacion con `-tags goolm`
3. **Register**: registra usuario Matrix, genera token + password + pickle key
4. **Verify E2EE**: genera cross-signing keys + recovery key
5. **Convert**: convierte a robot (config minimo, sin prompts, sin LLM, `command_prefix: ""`)
6. **Notify**: envia DM a los developers (DEVELOPER_MATRIX_USERS) presentandose

Si alguna etapa falla, revisar el error y corregir antes de continuar.

### Paso 3: Personalizar config

Editar `agents/<bot-id>/config.yaml`:
- `agent.description`: la descripcion del usuario
- `personality.prefix`: emoji representativo del bot (opcional)

### Paso 4: Crear comandos custom (si el usuario los pidio)

Si el usuario pidio comandos custom, crear `agents/<bot-id>/commands.go`:

```go
package <pkgname>

import (
    "context"
    "fmt"

    "github.com/enmanuel/agents/pkg/command"
    "github.com/enmanuel/agents/pkg/decision"
)

// CommandEntry pairs a spec with its handler.
type CommandEntry struct {
    Spec    command.Spec
    Handler func(ctx context.Context, msgCtx decision.MessageContext) string
}

// Commands returns the command specs and handlers for this bot.
func Commands() []CommandEntry {
    return []CommandEntry{
        {
            Spec: command.Spec{
                Name:        "<command-name>",
                Description: "<descripcion>",
                Usage:       "!<command-name> [args]",
            },
            Handler: func(ctx context.Context, msgCtx decision.MessageContext) string {
                // Implementar logica del comando
                return "respuesta"
            },
        },
    }
}
```

Luego registrar en `cmd/launcher/main.go` despues de `agents.NewRobot()`:

```go
if cfg.Agent.ID == "<bot-id>" {
    for _, cmd := range <pkg>.Commands() {
        robot.RegisterCommand(cmd.Spec, cmd.Handler)
    }
}
```

### Paso 5: Verificar compilacion

```bash
go build -tags goolm ./...
```

Si falla, corregir y reintentar.

### Paso 6: Checklist final

Verificar y reportar al usuario:

- [ ] `go build -tags goolm ./...` compila sin errores
- [ ] `agents/<id>/agent.go` exporta `Rules()` que retorna `nil`
- [ ] `agents/<id>/config.yaml` tiene `agent.type: robot` y `agent.id` coincide con directorio
- [ ] `cmd/launcher/main.go` tiene import del paquete del bot
- [ ] `.env` contiene las 4 env vars: `MATRIX_TOKEN_<NORM>`, `MATRIX_PASSWORD_<NORM>`, `PICKLE_KEY_<NORM>`, `SSSS_RECOVERY_KEY_<NORM>`
- [ ] No existe `agents/<id>/prompts/` (robots no necesitan system prompt)
- [ ] Si tiene comandos custom, estan registrados en el launcher

Informar al usuario:
```
Robot <bot-id> creado. Para arrancar:
  ./dev-scripts/server/start.sh

Comandos built-in: help, ping, status, info, version
Comandos custom: <lista si hay>
(Sin prefijo ! — el robot acepta comandos directamente)

Archivos a revisar:
  agents/<bot-id>/config.yaml    — configuracion
  agents/<bot-id>/commands.go    — comandos custom (si aplica)
```

## Diferencias clave con /create-agent

| Aspecto | /create-agent | /create-bot |
|---------|---------------|-------------|
| Runtime | `agents.New()` | `agents.NewRobot()` |
| Config type | `agent` (default) | `robot` |
| LLM | Si | No |
| System prompt | Obligatorio | No existe |
| Reglas | Si (agent.go con Rules) | nil |
| Tools | Opcionales | No |
| Memoria/Knowledge | Opcionales | No |
| Prefijo comandos | `!` (obligatorio) | `""` (sin prefijo por defecto) |
| Comandos built-in | help, ping, tools, tool, status, info, clear, prompts, version | help, ping, status, info, version |

## Notas importantes

- **Siempre compilar con `-tags goolm`**
- **Nunca commitear tokens ni passwords** — van en `.env`
- **Homeserver**: `https://matrix-af2f3d.organic-machine.com`
- **Server name**: `matrix-af2f3d.organic-machine.com`
- Referencia de robot existente: `agents/test-bot/`
- El bot-id DEBE coincidir entre directorio, config.yaml y `agents.Register()`