¿Qué hace skillbench?
Lint, puntúa, asegura y compara habilidades e instrucciones de agentes de IA en Codex, Claude Code, Cursor, Gemini CLI y GitHub Copilot.
¿Qué hace?
skillbench analiza archivos de habilidades e instrucciones para agentes de IA (como SKILL.md, INSTRUCTIONS.md, .cursorrules, etc.) para:
- Lint: Verifica la sintaxis, estructura y validez de las directivas.
- Puntúa: Asigna una puntuación de calidad basada en criterios como claridad, especificidad y completitud.
- Seguridad: Detecta posibles riesgos de seguridad, como inyección de plugins o comandos peligrosos.
- Benchmark: Evalúa el rendimiento de la instrucción ejecutándola en diferentes agentes y midiendo resultados.
Plataformas compatibles
| Plataforma | Archivos soportados |
|---|---|
| Codex | CODE_AGENT.md, instructions.txt |
| Claude Code | CLAUDE.md, instructions.md |
| Cursor | .cursorrules, rules.md |
| Gemini CLI | GEMINI.md, prompts.yaml |
| GitHub Copilot | COPILOT.md, copilot-instructions.md |
Cómo usar
# Instalar globalmente
npm install -g skillbench
# Lint de un archivo
skillbench lint SKILL.md
# Puntuar una instrucción
skillbench score my-instruction.md
# Ejecutar benchmark en todos los agentes
skillbench benchmark --agents codex,claude-code,cursor,gemini-copilot
# Escanear seguridad
skillbench security scan --all
Ejemplo de salida
{
"file": "SKILL.md",
"score": 87,
"issues": [
{"type": "warning", "message": "Faltan directivas de seguridad explícitas"}
],
"benchmark": {
"codex": {"success": true, "time_ms": 1200},
"claude-code": {"success": true, "time_ms": 950}
}
}
Configuración
Puedes configurar skillbench a través de un archivo .skillbenchrc en la raíz de tu proyecto:
{
"agents": ["codex", "claude-code"],
"securityLevel": "high",
"outputFormat": "json"
}
O usar variables de entorno para token de API o rutas personalizadas:
SKILLBENCH_API_KEYSKILLBENCH_CUSTOM_RULES_PATH