📌 Fijar IDs
¿Eres nuevo aquí? Fijar un ID quiere decir darle un nombre estable a una sección, archivo o etapa de la skill, en lugar de referirse a ella por su posición («la segunda regla», «el tercer paso»). Si alguien reordena `skill.md` después, una referencia por posición deja de funcionar; una referencia por nombre sigue siendo válida.
✓ Con ID fijo
- ✓"Ver la sección `#formato-saida`" — sigue siendo correcto aunque `skill.md` crezca
✗ Referencia por posición
- ✗"Ver el paso 3" — deja de funcionar sin avisar si alguien inserta un paso nuevo antes
💡 Consejo práctico
En `gerar-ata`, en vez de «vea la sección anterior», usa un encabezado markdown como `## Formato da saída` y haz referencia a ese título: es más fácil de mantener a medida que crece la skill.
📚 Precargar documentación
Recuerda el módulo 3.2: el nivel 3 (referencias) solo se lee cuando el `skill.md` indica que hay que leerlo. Pero a veces conviene incluir un resumen breve directamente en el nivel 2 (cuerpo del `skill.md`) en vez de pedir siempre que «vaya a buscarlo»: si el dato es pequeño y se usa cada vez, cada «búsqueda» es un viaje adicional que cuesta tiempo y tokens innecesariamente.
Ejemplo: lista de participantes fijos precargada
## Participantes frequentes (já sei quem são, não precisa perguntar)
- João (financeiro), Marcela (produto), você
## Formato de nomes desconhecidos
Se aparecer nome que não está na lista acima, pergunte o
cargo/área antes de fechar a ata.💡 Consejo práctico
Regla práctica: si un dato es pequeño (pocas líneas) y se usa en casi todas las ejecuciones, precárgalo. Si es grande o poco frecuente, déjalo en una referencia separada.
🤝 Delegar en subagentes
¿Eres nuevo aquí? Uno subagente es un «agente auxiliar» al que la conversación principal puede recurrir para que haga una parte del trabajo por su cuenta, en paralelo, y devuelva solo el resultado, sin llenar la conversación principal con todos los pasos intermedios. Las skills más avanzadas delegan etapas así cuando la tarea es grande o puede ejecutarse en paralelo con otra.
Ejemplo — fragmento de skill.md que delega
## Passo 3 — revisar o texto longo
Se as anotações passarem de 2 páginas, delegue a revisão de
consistência a um sub-agente dedicado, e só incorpore o
resultado final na ata — não processe o texto inteiro na
conversa principal.⚠️ Atención
Delegar todo, incluso las tareas pequeñas, es exagerado: cada subagente tiene su propio costo de inicialización. Reserva la delegación para partes realmente grandes o que se puedan paralelizar.
🔁 El ciclo honesto: invocar → observar → corregir → repetir
La verdad sin adornos: ninguna skill nace perfecta. La `gerar-ata` que probaste en el módulo 3.6 probablemente todavía falla en algún caso: un nombre mal escrito, una decisión ambigua, una sección vacía. Es normal. Lo que distingue una skill buena de una abandonada es repetir el ciclo varias veces: volver a invocarla, observar dónde falló, corregir una frase de `skill.md` y repetir. En la práctica, la mayoría de las skills solo se vuelve realmente confiable hacia la décima ejecución.
Leyenda: las cuatro etapas se repiten en círculo — la skill se vuelve más confiable con cada vuelta, no en el primer intento.
🔗 Skill = workflow + tools del WAT
Cierra el círculo con la Ruta 1: el framework WAT (Workflow, Agent, Tools) describe cualquier automatización como un workflow (qué hacer y en qué orden) ejecutado por un agente, que usa herramientas (con qué hacerlo). Una skill es exactamente esa combinación de workflow+tools, solo que empaquetada en un formato reutilizable: todo el `skill.md` é el workflow escrito; los scripts y archivos de referencia son las tools que activa este workflow.
Leyenda: skill = workflow del WAT empaquetado; los scripts y las referencias = las tools que usa ese workflow; el agente es quien ejecuta ambos juntos.
🏁 Cerrando la Ruta 3
Recorriste siete módulos: la anatomía de una skill (3.1), por qué 3 niveles de carga hacen que 20 skills no pesen (3.2), el framework de 6 pasos para escribir una buena skill (3.3), cómo la description activa el uso correcto (3.4), cuándo elegir una carpeta de proyecto o una carpeta global (3.5), creaste `gerar-ata` desde cero (3.6), y ahora sabes optimizar y ser honesto sobre el ciclo de mejora (3.7).
✅ Copy-run — auditoría rápida de una skill tuya
Objetivo: pedirle a Claude Code que revise una skill existente comparándola con todo lo que viste en esta ruta.
Leia a skill em ~/.claude/skills//skill.md e me
diga: a description é específica o bastante? o corpo tem
passo a passo claro? há algo que deveria virar referência
separada? sugira 3 melhorias objetivas. Cómo verificar: las sugerencias deben citar fragmentos concretos de tu `skill.md`, no dar consejos genéricos.
Lista de verificación final de la Trilha 3
- ☐ Sé explicar qué es una skill sin usar jerga, para que alguien sin experiencia lo entienda
- ☐ Entiendo por qué 20 skills instaladas no ocupan contexto
- ☐ Escribí y probé mi primera skill
- ☐ Sé cuándo usar la carpeta del proyecto y cuándo la carpeta global
- ☐ Sé qué significan fijar IDs, precargar y delegar a subagentes
Ejercicio de revisión: elige una tarea repetitiva tuya fuera de este curso y bosqueja su `skill.md` siguiendo el framework de 6 pasos del módulo 3.3; no hace falta implementarlo ahora, solo escribir el esqueleto.