¿Qué hace skill-port?
Empaqueta Skills de Agente en paquetes de directorio portátiles, restaurando la misma experiencia entre máquinas y harnesses (Claude Code/Goose/Codex/Cursor/...).
¿Qué hace?
- Empaquetar: Toma una skill de agente existente (por ejemplo, una carpeta
myskill/) y la comprime en un archivo.skill.tar.gzo en un directorio preparado para exportación. - Restaurar: Desempaqueta el archivo en cualquier harness compatible, recreando la estructura de archivos, instrucciones y configuraciones exactas.
- Portabilidad: Garantiza que la skill funcione idénticamente en diferentes máquinas y sistemas de ejecución (Claude Code, Goose, Codex, Cursor, etc.).
¿Por qué es útil?
- Compartir skills: Comparte skills entre compañeros de equipo sin preocuparte por diferencias de entorno.
- CI/CD: Incluye skills en pipelines de integración continua para pruebas automatizadas.
- Backup: Guarda copias portátiles de tus skills personalizadas.
- Migración: Traslada skills entre ordenadores o cuentas.
Plataformas soportadas
- Claude Code
- Goose
- Codex
- Cursor
- Cualquier harness que admita skills basadas en archivos/directorios.
Cómo funciona
- Empaquetado: El script recopila todos los archivos de la skill (incluyendo
SKILL.md,instructions.md, configuraciones, scripts auxiliares) y los combina en un único paquete comprimido. - Restauración: Al ejecutar el comando de restauración en el destino, el paquete se descomprime en la ubicación esperada por el harness (por ejemplo,
~/.config/claude-code/skills/o similar). - Verificación: Opcionalmente verifica que el harness pueda cargar la skill correctamente.
Ejemplo de uso
# Empaquetar una skill llamada "mi-skill"
skill-port pack ./mi-skill
# Salida: mi-skill.skill.tar.gz
# Restaurar la skill en otra máquina
skill-port restore mi-skill.skill.tar.gz
# La skill se despliega en el harness activo
Dependencias
- Bash (para scripts base)
- Python 3.8+ o Node.js 16+ (según implementación)
- Harness de agente instalado y configurado
Instalación
# vía npm (si es Node.js)
npm install -g @newbie-id/skill-port
# vía pip (si es Python)
pip install newbie-id-skill-port
Licencia
MIT