CHARLA TÉCNICA · UPAM3D
Buenas prácticas creando
agentes con Claude Code
Skills · Subagentes · Slash commands · MCPs
MaximoFN · 2026
Empezar bien: el comando /init
Generar el contexto que Claude usará durante toda la sesión
$ /init
- Crea el archivo
CLAUDE.mden la raíz del proyecto. - Indexa la estructura, dependencias y convenciones del repo.
- Ese archivo se carga en cada conversación: es el contexto base.
- Si el contexto cambia, se vuelve a ejecutar para actualizarlo.
Subagente claude-code-guide
El experto interno que sabe cómo se construye en Claude Code
$ @claude-code-guide
- Subagente que conoce skills, subagentes, slash commands, hooks y MCPs.
- Se invoca con
@claude-code-guide. - Le preguntas y te guía paso a paso para crearlos correctamente.
- Evita reinventar la rueda: aplica patrones probados.
- Útil cuando empiezas y cuando quieres revisar tu propio diseño.
Skills · “I know kung fu”
Conocimiento empaquetado para una tarea concreta
$ /skill
- Una skill enseña a Claude cómo hacer una tarea específica.
- Se compone de instrucciones + scripts + ejemplos en una carpeta.
- Invocación manual con
/skill; si no, el agente la llama cuando lo considera. - Reutilizable entre proyectos:
leer-excel-calidad,leer-pdf-calidad, etc. - Si la tarea se repite, conviértela en skill.
Subagentes
Procesos hijos con su propia ventana de contexto
$ @subagente
- Cada subagente tiene su propio contexto: no contamina el principal.
- Pueden lanzarse en paralelo para acelerar tareas independientes.
- Devuelven solo el resumen → mantienen limpia la conversación.
- Invocación manual con
@subagente; si no, el agente lo llama cuando lo considera. - Ideales para investigación, lectura masiva o tareas con mucho ruido.
MCPs · Model Context Protocol
Estándar para conectar herramientas externas
- Protocolo abierto para exponer herramientas externas a un LLM.
- Perdiendo terreno frente a las skills para tareas cotidianas.
- Su nicho actual: ejecutar programas o servicios largos / persistentes.
- Coste: ocupan mucha ventana de contexto al cargar todas sus tools.
- Patrón recomendado: una skill que explique a Claude cómo usar el MCP.
Slash commands
Secuencias de tareas reproducibles a un comando de distancia
$ /command
- Un comando = una secuencia bien definida de pasos.
- Se invocan con
/command— siempre los lanza el usuario. - Orquestan skills + subagentes + escritura de archivos.
- Aceptan argumentos:
/crear-doc-calidad "Higiene de Manos". - Convierten un proceso de horas en una sola llamada.
Próximos pasos · Aprender
Profundizar en cada pieza para diseñarlas mejor
- Skills: cuándo crear una, qué triggers definir, cómo estructurarla.
- Subagentes: criterios de aislamiento y reparto de contexto.
- Slash commands: orquestación, paralelismo y manejo de errores.
- Buenas prácticas de prompting interno y validación de salidas.
Próximos pasos · Iterar
Lo que se usa, mejora; lo que no se usa, sobra
- Probar las skills con casos reales y medir dónde fallan.
- Refinar instrucciones y triggers con cada uso.
- Eliminar pasos redundantes; añadir solo lo que aporta valor.
- Compartir las skills útiles con el resto del equipo.
FIN DE LA CHARLA
Gracias
¿Preguntas?