pappcorn/universe / packages/cris-asiste/skills/crear-agente
crear-agente
VerifiedTe 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.
| File | Kind | Size |
|---|---|---|
| GUIA.md | markdown | 4.0 KB |
| SKILL.md | skill md | 10.1 KB |
| assets/plantilla-agente.md | markdown | 1.3 KB |
| assets/plantilla-instrucciones-proyecto.md | markdown | 1002 B |
| references/anatomia-del-agente.md | markdown | 3.4 KB |
| references/entrevista.md | markdown | 2.3 KB |
| references/proyecto-desktop.md | markdown | 2.6 KB |
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."
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |