# Diseño de agentes de IA (/ai--agent-builder)

/ai--agent-builder es una skill de Claude Code de la sección IA y Agentes. Diseña e implementa un agente de IA en tu código: bucle, herramientas, memoria, límites de parada y un conjunto de pruebas de tareas.

- Versión web: https://skills.sgomez.dev/es/s/ai--agent-builder
- Sección: [IA y Agentes](https://skills.sgomez.dev/es/ai.md)
- Autor: Santiago Gómez de la Torre
- Licencia: MIT
- Código: https://github.com/sgomez-dev/claude-skills/blob/main/skills/ai/agent-builder.md
- Actualizada el 10 jul 2026

## Úsala cuando

- Tienes una tarea de varios pasos difícil de especificar de antemano
- Quieres que un modelo llame a herramientas y repita hasta terminar
- Necesitas límites de coste e iteraciones y pruebas antes de publicar

## No es para

- Tareas de pasos fijos, donde basta un flujo orquestado por código
- Coordinar varios agentes a la vez (para eso existe ai--multi-agent)

## Qué obtienes

Código del agente en tu repositorio (bucle, herramientas, límites de parada, registros) más un conjunto de 10-20 tareas de prueba con comprobación automática.

## Cómo pedírselo

- `/ai--agent-builder diseña un agente para responder tickets de soporte`
- `/ai--agent-builder ayúdame a definir las condiciones de parada de mi agente`
- `/ai--agent-builder qué herramientas debería exponerle a este agente`

## Instalar

macOS · Linux:

```
curl -fsSL https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.sh | bash
```

Windows:

```
irm https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.ps1 | iex
```

Plugin de Claude Code:

```
/plugin marketplace add sgomez-dev/claude-skills
/plugin install ai-skills@claude-skills-collection
```

## Permisos

- Lee: `**/*`
- Escribe: `**/*`
- Ejecuta: `project test/eval runners`
- Red: No
- Destructiva: No

## Descripción del autor (traducida)

Construye un agente de IA: diseño del bucle, superficie de herramientas, memoria, condiciones de parada y evaluaciones (evals)

## Preguntas sobre esta skill

### ¿Siempre crea un agente?

No. Si la tarea es una secuencia fija de pasos, construye un flujo orquestado por código en lugar de un agente. El bucle de agente se reserva para tareas de varios pasos, difíciles de especificar y con errores recuperables.

### ¿Qué límites de seguridad incluye?

Máximo de iteraciones, de tokens o coste por ejecución y tiempo límite, todos configurables y registrados al alcanzarse. Además pide confirmación explícita para acciones difíciles de revertir, como envíos, borrados o pagos.

### ¿Cómo comprueba que el agente funciona?

Con un conjunto de 10-20 tareas representativas, cada una con una comprobación programática del resultado. Se ejecuta tras cada cambio de prompt o herramientas y mide éxito, iteraciones y coste por tarea.


- [Cómo revisamos esto](https://skills.sgomez.dev/es/methodology.md)