OmniSys

Webinar en vivo el jueves 1 de octubre, 9:00 h CDMX

Skills con Claude Code

Deja de repetir el mismo prompt. Enséñaselo una vez.

~/.claude/skills/redactando-commits/SKILL.md
---
name: redactando-commits
description: Redacta el mensaje de commit a partir de los cambios
  preparados, siguiendo commits convencionales. Úsala cuando el
  usuario pida un commit o un mensaje de commit.
---

> dame un mensaje de commit para esto
✓ skill cargada sin escribir /
feat(facturas): agrega cupones de descuento
Agenda

Noventa minutos. Seis demos en vivo.

38 minutos de exposición y 52 con la terminal en pantalla. Cada demo tiene su corrida capturada paso a paso, para que la repases a tu ritmo.

Descargas

¿Qué paquete es para ti?

Todo se descarga aquí mismo, sin salir de la página.

Material para llevarte

Para leer, imprimir y consultar. Empieza por aquí.

Descargar

ZIP

  • Manual de Skills para Claude Code
  • Tarjeta de referencia para imprimir
  • Guía de tus primeros 30 días
  • El prompt destilador
  • Empieza aquí

Kit del asistente

Trece skills listas para instalar en tu equipo.

Descargar

ZIP

  • 13 skills en 4 dominios
  • 3 plantillas en blanco
  • El destilador como skill
  • Todo navegable en un solo HTML
  • Fuentes editables en markdown

Documentación del webinar

Para repasar las demos o replicar el webinar.

Descargar

ZIP · 3 MB

  • Guion de las seis demos
  • Seis corridas capturadas
  • Playbook y banco de preguntas
  • Ambiente de demostración
  • Carpeta de traspaso y tarjeta de cabina

El material, archivo por archivo.

Cada documento del primer paquete también se descarga por separado.

    Las trece skills del kit.

    Tócalas para leerlas completas antes de instalarlas. Muestran las decisiones, no solo las reglas.

    Una categoría completa
    cp -r kit-skills/calidad-documental/* ~/.claude/skills/
    Para todo un equipo, en un repositorio
    mkdir -p .claude/skills
    cp -r kit-skills/desarrollo/* .claude/skills/
    git add .claude/skills && git commit -m "add: kit de skills"

    La descripción está siempre en contexto. El cuerpo, no. Ese es todo el mecanismo.

    Una skill casi no cuesta nada hasta que hace falta. Lo que decide si existe en la práctica es una sola línea de texto.

    Conceptos

    Todo lo que decide una skill cabe en siete números.

    1,536caracteres para la descripción

    Qué hace y cuándo usarla, en tercera persona y con las palabras que escribirías tú. Si se pasa, se recorta por el final: el caso principal va primero.

    500líneas

    El tope del SKILL.md. Si lo pasa, hay que partirla.

    1nivel de referencia

    De SKILL.md a reference.md, nunca más profundo.

    3grados de libertad

    Cuánto detalle depende de qué tan frágil es la tarea.

    Alta · prosaMedia · plantillaBaja · comando exacto
    64caracteres para el nombre

    Un gerundio que describe la actividad: revisando-prs, no helper. El directorio define el comando.

    0veces que escribes /

    Si está bien descrita, se dispara sola.

    5capas para elegir
    CLAUDE.mdSkillSubagenteHookServidor MCP

    A fondo.

    Dos partes, dos costos

    Arriba, entre los tres guiones, los metadatos: siempre están en el contexto de Claude. Abajo, el cuerpo: solo entra cuando la skill se usa.

    Dónde vive

    NivelRutaAlcance
    Personal~/.claude/skills/Todos tus proyectos
    Proyecto.claude/skills/Ese repo, viaja con git
    PluginempaquetadaEspacio de nombres propio
    AdministradaorganizaciónToda la empresa

    La que usarás en equipo es la de proyecto: se versiona con el código y llega con el git clone.

    mi-skill/SKILL.md
    ---
    name: resumiendo-cambios
    description: Resume los cambios sin commitear
      y señala lo riesgoso. Úsala cuando el usuario
      pregunte qué cambió, pida un mensaje de commit
      o quiera revisar su diff.
    ---
    
    ## Cambios actuales
    !`git diff HEAD`
    
    ## Instrucciones
    Resume en dos o tres viñetas qué cambió.
    Luego lista los riesgos: manejo de errores
    ausente, valores hardcodeados, pruebas que
    quedaron desactualizadas.
    El destilador

    Convierte una conversación que ya funcionó en una skill.

    Pégalo al final de la conversación en la que resolviste algo que vas a volver a necesitar.

    Variante corta
    Destila esta conversación en un SKILL.md de Claude Code.
    
    Nombre en gerundio. Descripción en tercera persona con la fórmula
    [qué hace] + "Úsala cuando..." usando las palabras que yo usé de verdad
    en esta conversación, no lenguaje de manual. En el cuerpo pon solo el
    contexto que tuve que darte y que no sabías; quita todo lo que ya sabías.
    Menos de 60 líneas. Termina con un comentario del grado de libertad.
    
    Dame el archivo y el mkdir. Nada más.
    1. A

      Resuelve la tarea a mano.

      Con prompting normal, en una sesión cualquiera. Fíjate en qué contexto tuviste que dar y dónde corregiste a Claude.

    2. A

      Pega el destilador.

      La conversación ya tiene todo: el contexto, las correcciones y el resultado que aceptaste. Recorta lo que Claude ya sabía.

    3. B

      Pruébala en limpio.

      Sesión nueva. Pide la tarea en lenguaje natural, sin escribir /. Si se dispara sola, la descripción funciona.

    4. A

      Corrige una sola cosa.

      ¿No se disparó? Corrige la descripción. ¿Hizo otra cosa? Corrige el cuerpo. Nadie escribe un SKILL.md bueno a la primera.

    Documentación del webinar

    Con esto se transmitió. Ahora es tuyo.

    El ambiente que deja tu máquina igual que la de la transmisión, el guion de las demos y todo el paquete de documentación. Para repasar, o para replicar el webinar con tu equipo.

    Reprodúcelo en tu máquina

    ScriptQué hace
    preparar.shCrea ~/demo-webinar con un calculador de facturas y cuatro problemas sembrados, e instala las skills de las demos
    verificar.shRevisa versión, sesión, skills, diff y permisos, y dice qué falta
    resetear.shDevuelve todo al estado inicial entre una demo y otra

    Requiere Claude Code 2.1.233 o más nueva.

    Primera vez
    unzip ambiente-demo.zip
    bash ambiente-demo/preparar.sh
    bash ambiente-demo/verificar.sh
    Tus primeros 30 días

    Para que esto no se quede en el webinar.

    La mayoría de quienes ven un webinar no aplican nada. No es falta de interés: falta un siguiente paso concreto. Este es.

    1. Día 1, 20 minutos

      Instala una y observa.

      Copia redactando-commits, prepara un cambio y pide un mensaje de commit. Fíjate en que no escribiste /. Luego anota tu caso y destílalo.

    2. Semana 1

      Úsala, no la mejores.

      Tres usos reales. Una línea cada vez que tropiece. Sin datos de uso, las mejoras son suposiciones.

    3. Semana 2

      Una corrección y una skill más.

      Corrige una sola cosa con el ciclo A/B. La segunda, en otra categoría, sale en la mitad del tiempo.

    4. Semana 3

      Llévala al equipo.

      Límpiala con la variante para equipo del destilador, súbela al repositorio y pide una prueba sin explicar nada.

    5. Semana 4

      Mide y decide.

      ¿Cuántas en uso real? ¿Cuál no se invocó en dos semanas? Corre auditando-skills sobre las tuyas.

    Antes de dar una skill por terminada

    0 de 9

    Tu avance se guarda en este navegador.

    Los tres errores que hacen que esto se abandone

    1. Empezar por la skill perfectaLa primera debe ser fea y útil. La perfecta nunca se termina.
    2. Escribir cinco de golpeUna, usada tres veces, enseña más que cinco sin estrenar.
    3. Mejorarla sin usarlaLas mejoras en abstracto casi nunca son las que el uso revela.

    Antes de ejecutar una skill que no escribiste, lee su allowed-tools. Preaprueba, no restringe.

    Para llevarte

    Una frase por demo.

    1. Todo eso estaba escrito en un archivo, una sola vez.
    2. La descripción siempre está en contexto. El cuerpo, no.
    3. Si no se dispara, el problema está en la descripción.
    4. Nadie escribe un SKILL.md bueno de memoria y a la primera.
    5. Los scripts se ejecutan, no se leen.
    6. Las descripciones malas no las marca ninguna herramienta.