Communitygithub.com

xFurti/skillctl

Gestor universal de paquetes CLI para Skills de Agentes: manifiesto, lockfile y sincronización multi-agente (Cursor, Claude, Codex, Gemini). Requiere Node ≥22.13.

¿Qué es skillctl?

skillctl es un gestor de paquetes universal para Skills de Agentes de IA, diseñado para simplificar la instalación, gestión y sincronización de skills entre múltiples plataformas como Cursor, Claude, Codex y Gemini. Su modelo se basa en un almacenamiento canónico centralizado (~/.skillctl/skills/) y enlaces simbólicos, en lugar de copiar archivos manualmente. Incluye un manifiesto (agent-skills.json) y un archivo lock (agent-skills.lock), lo que permite reproducibilidad en equipo mediante control de versiones. Soporta un amplio rango de especificadores (file:, local:, github:, npm:, skills.sh/) y proporciona comandos como add, install, sync, update, audit y doctor. Es especialmente útil para equipos que trabajan con múltiples agentes de IA y necesitan un flujo consistente de skills sin duplicaciones ni conflictos.

Compatible con✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add xFurti/skillctl

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace skillctl?

Manual operativo para gestionar Skills de Agentes con la CLI skillctl. Ejecuta comandos reales; no simules salidas ni copies archivos SKILL.md entre directorios de agentes manualmente.

Reglas de oro

  1. Un único almacén canónico — las skills residen en ~/.skillctl/skills/<nombre>/; los agentes obtienen enlaces simbólicos mediante sync.
  2. Compromete manifiesto + lock — versiona agent-skills.json y agent-skills.lock en git para reproducibilidad en equipo.
  3. Solo especificadores portables — usa file:./<ruta>, local:imported/<nombre>, github:, npm: o skills.sh/; nunca comprometas rutas absolutas del directorio home.
  4. Instala antes de sincronizar — install materializa el almacén; sync solo reenlaza agentes.
  5. Verifica tras cambios — ejecuta skillctl doctor (y skillctl audit en CI).
  6. Prefiere importar antes que copiar manualmente — usa import from-project o import from-npx en lugar de duplicar carpetas de skills.

Árbol de decisión

SituaciónComando
Nuevo proyecto, sin manifiestoskillctl init o skillctl init --with-skill
Añadir una skill remota o localskillctl add <especificador> luego skillctl install
Skills ya existentes en .claude/skills, .codex/skills, etc.skillctl import from-project
Migrar desde npx skillsskillctl import from-npx
Reenlazar solo (lock sin cambios)skillctl sync
Recuperar desde origenskillctl update o skillctl update <nombre>
Instalación reproducible en CIskillctl install --frozen luego skillctl audit --strict
Rutas no portables en el lockskillctl install para reescribir; revisa las advertencias de skillctl doctor

Recetas rápidas

# Inicialización
skillctl init --with-skill
skillctl add github:vercel-labs/agent-skills#web-design-guidelines
skillctl install

# Skill local del proyecto
skillctl add file:./my-skill
skillctl install
skillctl sync

# Importar directorios de agentes existentes
skillctl import from-project --dry-run
skillctl import from-project

# Inspección
skillctl list
skillctl doctor
skillctl audit --json

Se espera que tras add file:./my-skill + install: el especificador del manifiesto sea file:./my-skill, y el canonicalPath del lock sea algo como ~/.skillctl/skills/my-skill.

Portabilidad (0.3.1+)

  • Portables: file:./rel, local:imported/<nombre>, especificadores remotos, canonicalPath: ~/.skillctl/skills/<nombre>.
  • No portables: rutas absolutas file:/Users/..., local:/abs/path, canonicalPath absoluto de otra máquina.
  • Si doctor advierte sobre rutas no portables, ejecuta skillctl install para reescribir el lock a partir del manifiesto.

Modos de fallo

SíntomaAcción
canonical path missingskillctl install
Discrepancia de integridadskillctl update <nombre> o skillctl install
El enlace simbólico falla (Windows)doctor lo señala; configura defaultMode: copy
Ningún agente enlazadoskillctl sync; habilita agentes en ~/.skillctl/config.json
Frozen install failedEl almacén está desincronizado; ejecuta install sin --frozen

Referencias

Skills relacionados