He publicado mis skills para Claude Code en GitHub

Llevo más de un año usando Claude Code a diario para desarrollar, escribir posts, gestionar el blog y automatizar partes de mi flujo de trabajo que antes me robaban tiempo. En ese proceso he ido construyendo lo que Anthropic llama skills: ficheros de instrucciones que le dicen a Claude cómo comportarse en tareas específicas.

Hasta ahora las tenía en local, esparcidas por varios proyectos. Esta semana las organicé, las limpié y las publiqué en un repo público: github.com/MarcosRamirez/SKILLS.

Qué es una skill para Claude Code

En Claude Code, una skill es un fichero SKILL.md que define un comportamiento específico. No es un plugin en el sentido clásico: no hay dependencias que instalar, no hay configuración de entorno, no hay un panel de administración. Es literalmente un fichero de texto con instrucciones en Markdown que le dice a Claude cómo comportarse cuando ejecuta una tarea concreta.

Lo copias a ~/.claude/skills/<nombre>/SKILL.md y Claude lo carga automáticamente en el contexto. A partir de ahí, cuando le pides que haga algo relacionado con esa skill, ya sabe cómo hacerlo. Sin que tengas que explicárselo cada vez, sin prompts repetitivos, sin pegar el mismo bloque de instrucciones en cada conversación.

Algunas skills funcionan solas. Otras necesitan hooks: scripts que se ejecutan en respuesta a eventos del sistema (guardar un fichero, hacer un commit, pegar una imagen). Los hooks son la parte que requiere un poco más de configuración, pero el proceso está documentado en el README.md de cada skill.

La idea detrás del repositorio es exactamente esa: plug-and-play. Copias, registras los hooks si los hay, y funciona. Sin configuración de mierda, sin leer documentación de 40 páginas.

Diferencia entre skill, hook y memoria

Para quien esté empezando con Claude Code, tres conceptos que se confunden:

• Skill: instrucciones de comportamiento para una tarea específica. Claude las carga y las aplica.
• Hook: script que se ejecuta automáticamente ante un evento (al hacer commit, al pegar una imagen, al guardar un fichero). Los hooks pueden disparar acciones sin que Claude tenga que intervenir.
• Memoria: información persistente sobre el proyecto o el usuario que Claude recupera entre conversaciones. No es ejecutable, es contexto.

Una skill bien construida puede combinar los tres: instrucciones de comportamiento, hooks que automatizan acciones secundarias y memoria que persiste entre sesiones.

La primera skill: save-image

El problema que resuelve es uno que cualquiera que use Claude Code para documentación o posts ha experimentado:

Estás escribiendo, necesitas añadir un screenshot, lo pegas en Claude Code y… nada. Claude lo ve, pero para guardarlo tienes que nombrarlo manualmente, decidir dónde va, exportarlo. Un proceso que rompe el ritmo cada vez.

save-image lo elimina por completo. Pegas la imagen, la skill la intercepta mediante un hook y la guarda a disco automáticamente, con un nombre generado a partir de la fecha y hora. Sin diálogos, sin interrupciones, sin que tengas que salir del flujo.

Lo que hace exactamente:

1. Detectas que has pegado una imagen en Claude Code
2. El hook se dispara en segundo plano
3. La imagen se guarda en el directorio configurado con nombre YYYY-MM-DD_HH-MM-SS_<índice>.<ext>
4. Claude recibe la ruta y puede referenciarla directamente en el fichero que estés editando

El resultado: trabajas sin interrupciones. La imagen está en disco cuando la necesitas, con una ruta que Claude ya conoce.

Cómo instalar cualquier skill del repo

El proceso es el mismo para todas las skills:

1. Copia el SKILL.md

mkdir -p ~/.claude/skills/save-image
cp skills/save-image/SKILL.md ~/.claude/skills/save-image/SKILL.md

2. Registra los hooks (si la skill los tiene)

Cada skill tiene un README.md que detalla exactamente qué hooks necesita y el comando para registrarlos. Para save-image:

# El README de la skill tiene el comando exacto
# Normalmente es añadir una línea al settings.json de Claude Code

3. Reinicia Claude Code

Nada más. No hay paso 4.

Cómo uso las skills en mi flujo de trabajo real

Para que quede concreto: este blog funciona con un conjunto de skills que automatizan partes del proceso editorial que de otra manera serían manuales y repetitivas.

Hay una skill de copywriting que define las reglas de estilo, categorías, estructura de frontmatter y checklist de publicación. Hay una skill de voz que guarda el corpus de mis posts anteriores y le dice a Claude cómo tiene que sonar el texto para que no parezca escrito por una IA corporativa. Hay una skill que genera imágenes de cabecera con un modelo de Inteligencia Artificial concreto y actualiza el frontmatter con la ruta correcta automáticamente. Hay una skill de publisher que calcula la siguiente fecha libre de publicación según la categoría del post y mueve el borrador a la carpeta correcta.

Todo eso son skills. Y ninguna de ellas requiere que yo explique las reglas cada vez que abro una conversación nueva. Claude las carga, las aplica y trabaja dentro de esos límites sin que tenga que recordárselo.

El resultado práctico: publico con más frecuencia, los posts tienen consistencia de estilo aunque los escriba en sesiones separadas, y no pierdo tiempo en tareas mecánicas que no aportan nada creativo.

Por qué lo publico

Tengo skills para un montón de cosas que uso en este blog. Muchas son demasiado específicas para tener utilidad general: dependen de la estructura concreta de este Jekyll, de mis categorías, de mis convenciones de naming. No tiene sentido publicarlas.

Pero otras, como save-image, resuelven problemas que cualquiera que use Claude Code de forma intensiva va a encontrar tarde o temprano. Esas sí tienen sentido compartirlas.

La idea es ir publicando las que tienen aplicación general a medida que las limpie. No voy a publicar por publicar: cada skill que entre al repo tiene que resolver un problema real, funcionar sin configuración compleja y estar documentada correctamente.

El repo acepta PRs. Si tienes una skill que resuelve un problema real y cumple con los tres requisitos (SKILL.md especificado, README con instrucciones claras, licencia MIT), abre una. Lo que no quiero es un cementerio de experimentos a medio hacer.

Preguntas frecuentes

¿Funciona en cualquier proyecto o solo en Claude Code CLI?

Las skills funcionan en Claude Code CLI (la herramienta de línea de comandos). Se instalan en ~/.claude/skills/ y están disponibles globalmente para todos tus proyectos.

¿Necesito saber programar para instalar una skill?

Para skills sin hooks, no. Copias un fichero y listo. Para skills con hooks sí necesitas ejecutar un comando y editar un JSON de configuración, pero el README de cada skill detalla exactamente qué tienes que hacer.

¿Puedo modificar una skill para adaptarla a mi flujo de trabajo?

Sí, y es exactamente lo que se espera. El SKILL.md es texto plano. Lo abres, lo modificas según tus necesidades y Claude aplica tu versión. Es una de las ventajas del formato: no hay código que mantener, no hay binarios que recompilar.

¿Qué pasa si una skill entra en conflicto con otra?

Las skills no interactúan entre sí directamente. Son instrucciones independientes que Claude carga en contexto. Si dos skills dan instrucciones contradictorias para la misma tarea, Claude intenta reconciliarlas, pero lo habitual es que cada skill cubra un dominio diferente y no haya conflicto.

Lo que viene

Hay varias skills en preparación que van a entrar en el repo en las próximas semanas. No voy a adelantar cuáles porque aún están en proceso, pero si usas Claude Code para desarrollo, escritura o automatización de flujos de trabajo, tiene sentido que le des una estrella al repo y lo sigas.

Puedes encontrarlo en github.com/MarcosRamirez/SKILLS.

---

Si trabajas con Inteligencia Artificial de forma profesional en tu empresa y necesitas implementar flujos de trabajo automatizados, hablamos.

Compártelo si te ha resultado útil.

¿Usas Claude Code? ¿Tienes skills propias que no has publicado en ningún sitio? Cuéntame.

Y… hasta aquí por hoy!