Resumen rápido El dilema habitual al construir asistentes con Claude Code es decidir si una funcionalidad debe ser una habilidad o un subagente. Las habilidades son como recetas que Claude lee y aplica; los subagentes son como compañeros especializados que trabajan con su propio contexto. Elegir bien evita dolores de cabeza y facilita la escalabilidad.

Hoja rápida de referencia Aspecto - Habilidades - Subagentes Qué son - Instrucciones que amplían el conocimiento de Claude - Un asistente IA separado con su propio contexto Cuándo las usa Claude - Automáticamente cuando son relevantes - Delegadas para flujos de trabajo complejos Mejor para - Funciones utilitarias, conversiones, plantillas, guías - Análisis multi paso, revisiones de código, investigaciones Contexto - Comparte el contexto principal del chat - Tiene su propia ventana de contexto aislada Analogía - Habilidad = darle a Claude un recetario - Subagente = contratar a un sous chef

Habilidades enfoque receta Las habilidades son archivos markdown con instrucciones que Claude lee cuando necesita ayuda concreta Ejemplo de estructura ~/.claude/skills/document-reader/ SKILL.md examples.md scripts/ converter.py Cuando usar habilidades Conversiones de archivos PDF a texto DOCX a texto Generacion de plantillas Guías de estilo Conocimientos de dominio Reutilidades rapidas Por que son excelentes Rapidas Reutilizables Ligeras Autoactivadas

Ejemplo de descripción de habilidad name : document-reader description : Convierte archivos .pdf .docx .xlsx a texto Use cuando se necesite leer adjuntos de tickets o extraer contenido de hojas y PDFs La clave es indicar claramente que hace y cuando usarla

Subagentes el compañero especializado Los subagentes delegan trabajo complejo y tienen su propio contexto aislado Cuándo usarlos Revisiones de codigo Flujos que analizan varios ficheros Investigaciones profundas Procesos que ensuciarian la conversacion principal Cuando necesitas razonamiento dedicado Por que molan Enfoque profundo Razonamiento multi paso Prompts especializados Separacion limpia

Ejemplo de subagente name : code-reviewer description : Revisa codigo en busca de buenas practicas y seguridad tools : Read Grep Glob Instruciones detalladas para el proceso de revision

Ejemplo real Lectura de documentos Tarea Leer PDF DOCX XLSX adjuntos de tickets Analisis mental No es razonamiento multi paso Necesita contexto propio No Resultado Decision Habilidad Convierte archivos a texto y queda disponible para otros agentes Si hubieses necesitado comparar documentos entre tickets o generar informes complejos habria sido subagente

Como trabajan juntos Ejemplo de colaboracion subagente investigador descarga adjunto.docx invoca document-reader habilidad convierte a texto analiza contenido devuelve hallazgos El subagente gestiona el flujo complejo y la habilidad la funcion utilitaria

Arbol de decision Es esto una conversion plantilla o utilidad reutilizable - Habilidad Requiere varios pasos de razonamiento o coordinacion - Subagente Se reutilizara en distintas tareas - Habilidad Es un flujo complejo con bucles de validacion - Subagente Es conocimiento nuevo que Claude no tiene - Habilidad Necesita coordinar varias operaciones - Subagente

Consejos rapidos para habilidades Mantener SKILL.md por debajo de 500 lineas Usar divulgacion progresiva Describir en tercera persona Incluir palabras disparadoras para activacion Hacerlas faciles de descubrir Para subagentes Escribir prompts sistema detallados Definir responsabilidades claras Limitar acceso a herramientas Probar activacion y comportamiento

Mi recomendacion Empieza con una habilidad salvo que necesites expresamente las ventajas de un subagente. Las habilidades son simples, rapidas y faciles de mantener. Pasa a subagente cuando el flujo tenga varios pasos, puntos de decision o validaciones iterativas.

Sobre Q2BSTUDIO En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida especializada en inteligencia artificial, ciberseguridad y servicios cloud aws y azure Ofrecemos soluciones de software a medida, implementaciones de aplicaciones a medida y servicios avanzados de inteligencia artificial para empresas Tambien cubrimos pentesting y ciberseguridad, servicios de inteligencia de negocio y Power BI para transformar datos en decisiones

Si trabajas con agentes IA o necesitas integrar habilidades y subagentes en tu ecosistema empresarial contacta con nosotros en Q2BSTUDIO para crear soluciones escalables y seguras que aprovechen agentes IA, automatizacion y analitica avanzada