Evita fragmentar habilidades de agentes usando npx skills

Si ejecutas varios agentes de IA o herramientas de línea de comandos (CLIs) en tu ordenador —ya sea Hermes, Claude Code, Codex, Antigravity, Kimi u otras herramientas compatibles—, es muy probable que te hayas topado con un problema bastante frustrante: la fragmentación de habilidades (skills). Cada agente o CLI mantiene su propia carpeta skills independiente, lo que provoca duplicidad de instalaciones, desfase de versiones y una gran carga de gestión.

En nuestro trabajo diario con agentes de IA, solíamos enfrentarnos a los siguientes problemas:

• Múltiples instalaciones: Instalar una nueva habilidad para un agente y luego tener que instalarla una y otra vez para los demás.
• Desfase de versiones (version drift): Personalizar o corregir una habilidad para un agente, olvidarse de actualizar los demás y acabar con agentes que se comportan de forma diferente.
• Gestión de habilidades: Tener que revisar la carpeta skills de cada agente en todo el sistema para saber qué habilidades estaban realmente instaladas.

La herramienta de línea de comandos npx skills, un CLI de código abierto desarrollado por Vercel, soluciona este problema permitiéndote gestionar una única carpeta skills centralizada y compartirla con todos tus agentes. Puedes echar un vistazo al repositorio de GitHub de npx skills.

Carpeta centralizada

La idea es sencilla: si apuntamos la carpeta skills de cada agente a la misma carpeta física, el problema de la fragmentación desaparece por completo.

Al instalar una habilidad mediante el CLI de npx skills, esta se descarga en la carpeta centralizada de tu equipo (~/.agents/skills). A continuación, el CLI crea un enlace simbólico (symlink, que funciona como un puntero directo) desde la carpeta skills de cada agente hacia esa carpeta centralizada.

Por ejemplo, cuando Claude Code busca habilidades en ~/.claude/skills/, se le redirige de forma transparente a ~/.agents/skills. Si realizas cualquier ajuste en una habilidad dentro de esa carpeta centralizada, todos los agentes verán la actualización de forma instantánea. Sin copias manuales, sin scripts de sincronización y sin desperdiciar espacio en el disco.

Instalación de npx skills y adición de una habilidad

Ejecuta el siguiente comando para empezar y añadir nuestra primera habilidad:

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

El CLI te preguntará si deseas configurar esto para un proyecto específico o de forma global. Por lo general, recomendamos elegir global para que todos los agentes compatibles puedan acceder a ella:

A continuación, asegúrate de seleccionar Symlink para garantizar una única fuente de verdad:

Una vez hecho esto, podemos verificar que la habilidad se ha instalado en la carpeta centralizada en ~/.agents/skills:

¡Abre el CLI de Kimi (o cualquier otro agente) y la habilidad excalidraw-diagram estará disponible y lista para usar!

Creación de una habilidad desde cero

Para crear tus propias habilidades, puedes utilizar la herramienta skill-creator de Anthropic. Instálala de la siguiente manera:

npx skills add https://github.com/anthropics/skills --skill skill-creator

Ahora, en Kimi o en cualquier otro agente, introduce la siguiente instrucción (prompt):

Use the skill-creator to help me build a skill for creating a product landing page

¡Kimi o tu agente detectará automáticamente el skill-creator y te guiará paso a paso por todo el proceso!

Otros comandos útiles de npx skills

Aquí tienes algunos otros comandos prácticos:

• npx skills ls -g: Muestra todas las habilidades instaladas globalmente
• npx skills update: Mantén todas tus habilidades actualizadas con un solo comando
• npx skills remove: Desinstala o elimina una habilidad de forma interactiva

Por favor, consulta el repositorio de GitHub de npx skills para ver más comandos y referencias.

Yendo un paso más allá

Dado que ahora todas las habilidades se encuentran en un único lugar (~/.agents/skills), podemos inicializarlo como un repositorio Git y subirlo a GitHub o GitLab.

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

De este modo, dispondremos de un historial completo de todos los cambios en las habilidades, lo que significa que podremos revertirlos fácilmente si una actualización rompe algo. Además, podemos sincronizar las habilidades sin problemas entre varios equipos (como un portátil y un ordenador de sobremesa) ejecutando un rápido git pull.

Aspectos a tener en cuenta (Seguridad y riesgos)

• La compatibilidad varía: No todas las plataformas de agentes admiten aún todas las funciones (como hooks personalizados o herramientas permitidas específicas). Una habilidad puede funcionar de maravilla en un agente pero quedarse corta en otro.
• Confía en la fuente: Instala únicamente habilidades procedentes de fuentes de confianza.
• Revisa antes de ejecutar: Si utilizas una habilidad personalizada o de terceros, revisa los archivos (especialmente en la carpeta scripts/) antes de permitir que tu agente la ejecute.
• Principio de mínimo privilegio: Intenta no conceder a una habilidad más permisos de herramientas o acceso del que sea estrictamente necesario para realizar su trabajo.
• Nunca expongas credenciales: Mantén tus claves API y secretos fuera de los archivos de tus habilidades.

Configurar una "fuente única de verdad" centralizada con npx skills ha evitado frustraciones y duplicidad de trabajo a nuestro equipo. Te recomendamos encarecidamente que lo pruebes; ¡las capacidades de la IA se multiplican a medida que crecen tus habilidades!