itaywol/adeptability

Adeptability: Habilidades de IA portátiles

Adeptability es un CLI que te permite gestionar y sincronizar habilidades de agentes de IA a través de múltiples entornos. Define una habilidad una vez y distribúyela a Claude Code, Cursor, Copilot, Codex, OpenCode y más de 45 agentes de codificación de IA.

Características principales

• Portabilidad: Escribe una habilidad y pruébala en cualquier agente compatible.
• Sincronización automática: Sincroniza tus habilidades con un solo comando.
• Seguridad: Escáner de seguridad integrado para detectar vulnerabilidades en las habilidades.
• Detección de desviación: Verifica que las habilidades sincronizadas no hayan sido modificadas inesperadamente (content-hash drift detection).
• Gestión de versiones: Al igual que un gestor de paquetes, puedes instalar, actualizar y eliminar habilidades fácilmente.

Plataformas compatibles

Adeptability es compatible con una amplia gama de agentes de IA, incluyendo:

• Claude Code
• Cursor
• GitHub Copilot
• Codex CLI
• OpenCode
• Y más de 45 agentes adicionales.

Cómo funciona

1. Define tu habilidad: Crea un archivo de especificación de habilidad (generalmente en formato Markdown) que describa el comportamiento, los comandos y las restricciones de tu agente.
2. Configura las salidas: Especifica a qué agentes quieres sincronizar la habilidad y en qué formato.
3. Ejecuta la sincronización: Usa el comando adeptability sync para distribuir la habilidad a todos los entornos configurados.
4. Verifica el estado: Usa adeptability status para comprobar si todas las habilidades están sincronizadas y detectar posibles desviaciones.

Instalación

npm install -g adeptability
# o
pip install adeptability

Uso básico

# Inicializar un nuevo proyecto de habilidades
desperness init

# Agregar una habilidad
desperness add ./mi-habilidad.md

# Sincronizar a todos los agentes configurados
desperness sync

# Verificar el estado de las habilidades
desperness status

# Escanear habilidades en busca de problemas de seguridad
desperness scan

Configuración

La configuración se almacena en un archivo adeptability.json en la raíz del proyecto. Aquí puedes definir los agentes de destino y las rutas de salida.

Ejemplo de configuración:

{
  "agents": {
    "claude-code": {
      "enabled": true,
      "outputPath": ".claude/skills/"
    },
    "cursor": {
      "enabled": true,
      "outputPath": ".cursor/skills/"
    },
    "copilot": {
      "enabled": true,
      "outputPath": ".github/copilot-instructions.md"
    }
  },
  "security": {
    "enabled": true,
    "scanOnSync": true
  },
  "driftDetection": {
    "enabled": true,
    "autoRepair": false
  }
}

Escáner de seguridad

El escáner de seguridad integrado revisa tus habilidades en busca de:

• Comandos peligrosos (como rm -rf)
• Variables de entorno expuestas
• Código ofuscado
• Referencias a malware

Ejecuta adeptability scan para analizar tus habilidades.

Detección de desviación de contenido

Adeptability calcula un hash del contenido de cada habilidad sincronizada. Si el contenido cambia sin autorización, el sistema lo detecta y te alerta. Ejecuta adeptability status para verificar.

API de habilidades

Puedes crear tus propias habilidades programáticamente usando la API de Adeptability. Consulta la documentación de la API para más detalles.

Contribuir

Las contribuciones son bienvenidas. Por favor, consulta la guía de contribución para más información.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.