¿Qué hace ai-skill-create?
AI Skill Create: kit de herramientas para crear, validar, probar y empaquetar habilidades reutilizables de agentes de IA y habilidades de Codex.
Características
- Creación rápida: Genera la estructura de carpetas y archivos base de una habilidad a partir de una plantilla.
- Validación automática: Verifica la sintaxis y el formato del manifiesto (
SKILL.md,skill.yaml). - Pruebas integradas: Ejecuta pruebas unitarias y de integración para garantizar el comportamiento esperado.
- Empaquetado: Prepara el skill para su publicación en repositorios (npm, PyPI, GitHub).
- Compatibilidad múltiple: Funciona con agentes como Claude Code, Cursor, Codex, y más.
Instalación
npm install -g @ucsahinn/ai-skill-create
# o
pip install ai-skill-create
Uso básico
- Crear un nuevo skill:
ai-skill-create init mi-skill-de-ejemplo
- Validar el proyecto actual:
ai-skill-create validate
- Ejecutar pruebas:
ai-skill-create test
- Empaquetar para publicación:
ai-skill-create package
Estructura del proyecto
mi-skill-de-ejemplo/
├── SKILL.md # Documentación principal del skill
├── skill.yaml # Manifiesto de configuración
├── src/ # Código fuente del skill
│ └── index.js
├── tests/ # Pruebas automatizadas
│ └── test.js
└── package.json # Dependencias y metadatos
Validación
El comando validate comprueba:
- Formato correcto de
SKILL.mdyskill.yaml. - Presencia de todas las secciones obligatorias.
- Coherencia entre los archivos de configuración.
Pruebas
El comando test ejecuta:
- Pruebas unitarias (Jest, Mocha).
- Pruebas de integración simulando interacciones con el agente.
- Verificación de cobertura de código mínima (por defecto 80%).
Empaquetado
El comando package prepara:
- Archivos necesarios para publicación en npm o PyPI.
- Tarball comprimido con el skill listo para distribuir.
- Documentación generada automáticamente.
Soporte de plataformas
| Plataforma | Compatibilidad |
|---|---|
| Claude Code | Sí |
| Cursor | Sí |
| Codex | Sí |
| Otros agentes compatibles con SKILL.md | Parcial |
Enlaces
Skill desarrollado por ucsahinn. Contribuciones bienvenidas.