Skip to content

pappcorn/universe / packages/cris-asiste/skills/crear-agente

crear-agente

Verified

Te guía para crear TU propio agente: un ayudante de IA con un trabajo claro, que sabe dónde buscar la información y qué no debe hacer nunca. Primero te entrevista y después escribe el agente contigo. En Claude Code crea el archivo del subagente en `.claude/agents/`; en Claude Desktop o claude.ai arma el equivalente (un Proyecto con instrucciones, conocimiento y skills). Úsala cuando digas "quiero crear un agente", "hazme un asistente para X", "necesito un ayudante que se encargue de Y", "configurar mi IA", "make me an agent", "crear un subagente", o pidas mejorar un agente que ya tienes, incluso si describes el trabajo sin decir la palabra agente.

references/anatomia-del-agente.md

View on GitHub
# Anatomía de un agente en Claude Code

Un agente es **un solo archivo** `.md` en `.claude/agents/`. Si necesita scripts, esos viven en una
skill (carpeta aparte con su `SKILL.md`), nunca dentro de la carpeta de agentes.

## Frontmatter

```yaml
---
name: nombre-en-minusculas # igual al nombre del archivo, solo letras minúsculas y guiones
description: Qué es y cuándo usarlo # el enrutador: lo más importante del archivo
tools: Read, Grep, Glob # lo mínimo que el trabajo necesita
model: sonnet # sonnet, haiku o inherit
---
```

- **name.** Igual al nombre del archivo, para que buscarlo sea fácil. Sin sufijo "-agent".
- **description.** Claude decide si delega leyendo solo esto. Qué es, qué cubre, frases reales con
  las que la persona lo pediría y dónde vive su información. Sé insistente: pocas descripciones
  fallan por ser largas, muchas por tímidas.
- **model.** `haiku` para tareas simples y rápidas, `sonnet` para el trabajo diario, `inherit` cuando
  el producto del agente es criterio (revisar un contrato, dar un veredicto, cuidar una voz).
- **tools.** Ver la tabla.

## Qué herramientas darle

| El agente...              | Herramientas                                  |
| ------------------------- | --------------------------------------------- |
| Solo lee y analiza        | `Read, Grep, Glob`                            |
| Además busca en internet  | `Read, Grep, Glob, WebFetch, WebSearch`       |
| Escribe o edita archivos  | `Read, Grep, Glob, Edit, Write`               |
| Corre comandos            | Suma `Bash` solo si de verdad lo necesita     |
| Usa un servicio conectado | El nombre de las herramientas de ese conector |

La ausencia de una herramienta es un límite de seguridad. Un agente sin `Edit` ni `Write` no puede
dañar tus archivos aunque se equivoque.

## Las secciones del cuerpo, en este orden

1. **Quién eres** (obligatoria). Dos o tres frases: el rol, para quién trabaja, el tono.
2. **Antes de actuar, lee** (obligatoria). La fuente de verdad: un documento, una carpeta, su
   memoria. Si no existe, la crea en la primera corrida y no inventa contexto.
3. **El tema en pocas líneas** (recomendada). Un resumen de cómo se ve el mundo del agente, con
   fechas. Le dices que verifique antes de citar de memoria.
4. **Procedimientos** (obligatoria). Los 2 a 5 flujos que repite. Para cada uno: cuándo arranca, los
   pasos y cómo se ve "terminado".
5. **Memoria** (si recuerda). Qué archivos, qué guarda cada uno, leer al empezar y escribir al cerrar
   una decisión. Incluye la cláusula de aprendizaje: lo que la realidad contradiga se corrige con
   fecha y motivo.
6. **Reglas** (obligatoria). Solo límites reales, cada uno con su porqué. Si todo es regla, nada lo es.
7. **Estilo** (obligatoria). Idioma, longitud, cómo presentar opciones (una tabla corta con una
   recomendación), qué explicar y qué dar por sabido.

## Ejemplo de descripción floja y buena

Floja: "Ayudante para temas de finanzas."

Buena: "Analista de gastos personales. Revisa los extractos de la carpeta `finanzas/`, clasifica los
movimientos y avisa de cargos raros. Úsalo cuando la persona diga 'revisa mis gastos', 'cuánto gasté
en X', 'qué cobros no reconozco' o suba un extracto. Su memoria vive en `memoria/finanzas.md`."

## Una regla vale lo que vale su porqué

Mejor: "No envíes correos sin mostrármelos antes, porque una vez salió uno a la persona equivocada."
Peor: "NUNCA ENVÍES CORREOS."
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall