Mapa de la ruta
Contenido detallado
🧱 Skills y subagentes: qué son
Las dos piezas que transforman Claude Code en una fábrica: skill (capacidad reutilizable bajo demanda) y subagente (trabajo aislado, contexto propio). Cuándo usar cada uno y por qué eso se convierte en un activo.
Una capacidad que Claude Code carga cuando la necesita: un archivo SKILL.md con instrucciones y referencias. La enseñas una vez y la usas cada vez que se active el disparador.
Cada tarea repetida de la Fábrica (diagnosticar, generar documentos) se convierte en una skill. Dejas de volver a explicar y ganas consistencia.
Bajo demanda · SKILL.md · reutilización · activación por description.
Una instancia independiente de Claude, con su propia ventana de contexto, prompt del sistema y herramientas. Recibe una tarea, trabaja por su cuenta y devuelve solo el resultado.
Investigar una empresa llena el contexto. Un subagente aísla ese desorden y te entrega solo lo esencial: el agente principal no se ensucia.
Contexto aislado · system prompt · herramientas propias · devuelve un resumen.
Skill = una habilidad que obtiene el agente principal (generar PPTX). Subagente = un trabajador independiente para una misión que consume mucho contexto (recorrer la web).
Elegir mal cuesta contexto y tiempo. La regla simple evita la sobreingeniería.
Habilidad vs. delegación · costo de contexto · «en el mismo hilo» vs. «hilo separado».
Un archivo SKILL.md con frontmatter (name + description) en la parte superior y el cuerpo en Markdown con los pasos. La description es lo que activa la skill.
Escribir la description adecuada determina si se usa la skill. Es la pieza más importante y la más ignorada.
Frontmatter · name · description-gatilho · cuerpo con pasos.
Las Skills están en .claude/skills/ (del proyecto) o ~/.claude/skills/ (personales). Los subagentes quedan en .claude/agents/. Cada uno en una carpeta con su archivo.
Saber dónde está es lo que permite que Claude Code encuentre el recurso. Personal = sirve para todos los proyectos; del proyecto = viene incluido en el repo.
.claude/skills · .claude/agents · alcance del proyecto vs. personal.
Cada skill y agente es una pieza que construyes una vez y reutilizas siempre. Juntas, forman el engranaje de la Fábrica: tu arsenal.
Es la tesis "entrada mínima, salida máxima" convertida en código. El esfuerzo se dedica a la construcción, no a la entrega.
Activo reutilizable · composición · arsenal · costo marginal casi cero.
🎯 Crea tu primera skill (diagnostico-ia)
Desde el disparador hasta el empaquetado: definir la description que activa la skill, escribir el cuerpo determinístico, adjuntar las cheat sheets de la T2, probar, iterar y versionar. Al final, una skill que genera un minidiagnóstico.
La description del frontmatter describe cuándo usar la skill. «Úsala para diagnosticar la madurez de IA de una empresa descrita en un texto.»
Si la description es vaga, la skill nunca se activa. Una buena description = verbos claros + disparadores concretos.
Disparador · verbos de acción · «úsalo cuando» · especificidad.
El cuerpo en Markdown enumera los pasos: leer sobre la empresa, calificar la madurez del 1 al 5, enumerar 3 quick wins, sugerir una hoja de ruta 30/60/90.
Los pasos numerados y específicos producen resultados repetibles. Las instrucciones vagas generan resultados distintos cada vez.
Pasos numerados · determinismo · formato de salida fijo.
La skill apunta a archivos de apoyo (los cheat sheets de madurez y quick wins que sintetizaste en la Trilha 2), que se cargan solo cuando hacen falta.
Las referencias aportan a la skill el rigor de una consultoría sin sobrecargar el SKILL.md. RAG perezoso aplicado.
Archivos de apoyo · carga bajo demanda · contexto conciso.
Ejecuta la skill con una empresa real y verifica: ¿se activó sola? ¿El resultado incluye madurez, quick wins y roadmap?
Una prueba con un caso real revela si la description se activa y si el resultado es útil. Sin eso, es solo teoría.
Caso de prueba · ejecución · revisión del resultado.
Ajustar la description y los pasos según la prueba, completar la carpeta de la skill (SKILL.md + referencias) y dejarla lista para usar.
La primera versión rara vez acierta. Iterar es el trabajo real; empaquetarla es lo que la convierte en un activo.
Iteración · carpeta de la skill · listo para reutilizar.
Versiona la skill en Git (junto con el proyecto) y, si quieres, compártela con el equipo o la comunidad. Historial = evolución rastreable.
Versionar protege tu activo y te permite mejorarlo sin miedo. Compartir genera autoridad.
Git · versión · compartir · activo duradero.
📄 La skill de documentos (DocX/PPTX/Excel/PDF)
Los entregables elegantes no salen de Markdown: salen de Python. python-docx, python-pptx, openpyxl (con convención de colores) y reportlab, agrupados en la skill generar-entregable. Entra Markdown, salen .docx y .pptx.
El cliente abre .docx, .pptx, .xlsx y .pdf; no Markdown sin formato. Generar mediante código hace que todo quede bien formateado, sea repetible y lleve tu marca.
Es lo que hace que el paquete parezca una consultoría de élite. Sin esto, el entregable muere en el editor de texto.
Entregable final · formato · repetible · marca.
La biblioteca que crea .docx: Document(), add_heading, add_paragraph, add_table y ejecuta con color/negrita. Genera el informe y el SOW.
El informe final y el SOW son entregables de Word. Dominar docx significa generar ambos sin trabajo manual.
Document · headings · tablas · runs formateados.
Presentation(), diapositivas por diseño (0 título, 6 en blanco), cuadros de texto, viñetas y RGBColor para colores. Genera el deck ejecutivo.
El deck es lo que cierra la venta (T5). Cuidado con la trampa: es RGBColor, no RgbColor.
Diseños · cuadros de texto · RGBColor · presentación ejecutiva.
Crea un .xlsx con fórmulas reales (nunca valores fijos) y la convención de colores: azul = entrada, negro = fórmula, verde = enlace, rojo = externo, amarillo = supuesto.
La calculadora de ROI está en Excel. Las fórmulas y los colores adecuados hacen que el cliente confíe y pueda editar las premisas.
Fórmulas vs. valores · indexación basada en 1 · convención de colores · ROI.
El método Platypus arma un story de elementos (Paragraph, Spacer, Table) y termina con doc.build(story). Genera PDFs listos para enviar.
El PDF es el formato universal de entrega. Platypus permite controlar el estilo sin modificar coordenadas.
Platypus · historia · build al final · estilos.
Envolver las cuatro bibliotecas en una skill: "dado un Markdown, genera el .docx/.pptx/.xlsx/.pdf correspondiente". Una sola referencia para todo el paquete.
Se convierte en el motor de salida de la Fábrica. Recibe Markdown de cualquier prompt y genera un archivo profesional.
gerar-entregavel · wrapper · Markdown → archivo · motor de salida.
🕵️ Construye tu subagente (investigador y redactor)
Dos trabajadores aislados: el investigador-empresa recopila contexto estructurado y el redactor-estrategia prepara el entregable. Salida con un schema confiable, orquestados con la skill — y cuándo vale la pena paralelizar.
Un archivo de agente: frontmatter (name/description), prompt del sistema (quién es), herramientas habilitadas y el formato de salida que debe devolver.
Definir bien estas cuatro partes es lo que distingue a un agente útil de uno que devuelve texto suelto.
Prompt del sistema · herramientas · resultado esperado · alcance.
Un subagente que recibe el nombre y la descripción de la empresa, investiga y devuelve un CompanyContext: sector, stack, problemas, competidores e iniciativas de IA.
Es la Fase 1 de la Fábrica convertida en trabajador. Aísla la investigación pesada y devuelve solo el contexto limpio.
CompanyContext · investigación aislada · salida estructurada.
Recibe el CompanyContext + un framework (p. ej., quick wins) y escribe el entregable en Markdown, listo para que la skill gerar-entregavel le dé formato.
Separa la investigación de la redacción. Cada agente hace bien una sola cosa; así es fácil probarlo y mejorarlo.
Contexto + framework → borrador · separación de roles.
Pedirle al agente que devuelva JSON en un formato fijo (un schema). Como el CompanyInput/ResearchOutput de la arquitectura: campos predecibles.
La salida estructurada es lo que permite encadenar agentes. El texto libre rompe el pipeline; el schema, no.
Schema · JSON previsible · encadenable · contrato.
El agente principal llama al investigador de empresas, pasa el contexto al redactor de estrategia y usa la skill gerar-entregavel para cerrar el archivo.
Es la Fábrica en miniatura: investigación → redacción → documento. Orquestar es el trabajo del constructor.
Orquestación · encadenamiento · pipeline de investigación→redacción→documento.
Activar varios subagentes al mismo tiempo cuando las tareas son independientes; por ejemplo, investigar 3 empresas en paralelo, sin estado compartido.
Paralelizar tareas independientes ahorra tiempo. Pero si una depende de otra, es secuencial; saber distinguirlo evita errores.
Paralelo vs. secuencial · independencia · sin estado compartido.