Mapa de la ruta
Contenido detallado
🧩 Composición de skills
Las Skills se convierten en pipelines cuando las encadenas — la salida de una alimenta la siguiente.
Formas típicas de encadenar skills: secuencial, paralela y condicional; cada una tiene su propio disparador.
Sin un estándar, reinventas el pipeline con cada feature. Los patrones con nombre aceleran la decisión.
Pipeline, fan-out/fan-in, gate, orquestación.
Flujo estándar de Matt: la alineación se convierte en PRD, luego en issues y después en ciclos TDD hasta el merge.
Es el ejemplo vivo de composición. Reproducir el flujo da resultados inmediatos.
Handoff, contrato de salida, flujo canónico.
Una skill que orquesta otras skills: se usa cuando la misma secuencia se repite en varios proyectos.
Macro demasiado pronto y abstracción prematura. Demasiado tarde y hay copy-paste de pipeline.
Regla de tres, abstracción oportuna, skill compositora.
Las skills no guardan estado: CONTEXT.md es el canal de memoria entre ellas dentro del proyecto.
Sin estado compartido, cada skill vuelve a aprender el dominio. Con CONTEXT.md, hay continuidad.
Persistencia, contrato documental, fuente única de verdad.
Encadenamientos demasiado largos, skills con ámbitos superpuestos, dependencias cíclicas.
Detectarlo pronto evita un pipeline frágil que nadie entiende.
Acoplamiento excesivo, alcance difuso, ciclo, explosión de prompts.
Caso de refactorización: /zoom-out → /improve-codebase-architecture → /to-issues → /tdd → review.
Ver la composición completa en un problema real fija el patrón en la cabeza.
Refactor seguro, encadenamiento real, gates intermedios.
✏️ Personalizando skills
Toma la skill y hazla tuya: sin forks innecesarios y sin perder el upstream.
Anatomía del archivo: frontmatter YAML (nombre, descripción, activadores) y cuerpo Markdown con instrucciones.
Si no entiendes la estructura, la personalización rompe la carga de la skill.
Frontmatter, body, secciones obligatorias, parser.
Campos que determinan cuándo el agente carga la skill: frases, contextos y activadores explícitos.
Un trigger deficiente = la skill nunca se activa o se activa siempre. Una descripción débil = el agente la ignora.
Frase de activación, descripción, alcance, falsos positivos.
Las Skills tienen plantillas (PRD, ADR, issue). Editar las plantillas ajusta el resultado sin modificar la lógica.
Personalización más barata y segura: cambias la forma, mantienes el comportamiento.
Plantilla, contrato de salida, secciones, marcadores de posición.
Fork = copia independiente; override = la skill local con el mismo nombre se impone sobre la global en ese proyecto.
El fork pierde el upstream. El override mantiene las actualizaciones. Una decisión equivocada sale cara después.
Alcance local/global, precedencia, upstream, drift.
Tratar el directorio de skills como un repo: branches, PRs, revisión y changelog para los cambios.
Sin control de versiones, la personalización se convierte en «.skill.bak.final.v2». El equipo pierde la trazabilidad.
Skills-as-code, semver, changelog, revisión de skills.
Walkthrough que adapta /grill-with-docs a un dominio específico: términos, preguntas y referencias propias.
Ver una personalización real disipa el miedo a modificar una skill "oficial".
Ajuste al dominio, prompt local, referencias específicas, fork mínimo.
🤝 Integración con otros agentes
Claude Code, Codex, Cursor: una skill para todos, sin reescribir.
Cada agente carga las skills de manera diferente. Identifica qué es portable y qué es específico.
Mantener N versiones de la misma skill es insostenible. Saber qué es común reduce las copias.
Runtime, portabilidad, matriz de capacidades y superficie de exposición.
Una skill que empaqueta un SKILL.md en el formato portable y lo publica para Claude Code, Codex y otros.
Build once, run anywhere — sin polyskill, mantienes N copias divergentes.
Source of truth, transpile, adapter, runtime target.
Slash commands, hooks, MCP, permisos: cada runtime expone un subconjunto. Aprende cuáles afectan la portabilidad.
Una skill que asume un hook de Claude Code no funciona en Codex. Mapear las brechas antes evita un debug confuso.
Hook, MCP, slash command, permission, sandbox.
Exponer skills mediante un servidor MCP: cualquier agente compatible las consume sin instalarlas localmente.
Todo el equipo usa la misma versión de la skill, con actualización centralizada.
Servidor MCP, herramienta, manifiesto, descubrimiento dinámico.
Ejecutar skills en pipelines (GitHub Actions, GitLab CI): revisión, lint y actualización de documentación automatizados.
Una skill en CI se convierte en un gate confiable. Pasas de "si te acuerdas de ejecutarla" a "siempre se ejecuta".
Pipeline, gate, agente headless, artefacto, idempotencia.
Workflow que activa /tdd en los PR nuevos: el agente genera una prueba que falla, implementa la solución y crea un commit.
El caso práctico cierra la ruta: todo lo aprendido funciona sin que tengas que abrir el IDE.
Workflow YAML, secret, agent runner, automatización de PR.