¿Qué hace doodle?
Un linter para archivos SKILL.md de Claude. Detecta descripciones vagas, cuerpos sobredimensionados y fallos silenciosos en los triggers que impiden que las habilidades se activen.
Instalación
Puedes instalar doodle globalmente con npm:
npm install -g @krishyaid-coder/doodle
O ejecutarlo directamente con npx:
npx @krishyaid-coder/doodle
Uso
Para lintar un archivo SKILL.md específico:
doodle lint ruta/a/SKILL.md
Para lintar todos los archivos SKILL.md en el directorio actual y subdirectorios:
doodle lint .
Opciones
--fix: Intenta corregir automáticamente algunos problemas detectados.--verbose: Muestra información detallada sobre cada regla ejecutada.--format <formato>: Define el formato de salida (pretty,json,silent).
Reglas
| Regla | ID | Descripción |
|---|---|---|
| Descripción vaga | vague-description | La descripción de la habilidad debe ser específica y descriptiva. |
| Cuerpo sobredimensionado | oversized-body | El cuerpo de la habilidad no debe exceder los 1000 caracteres. |
| Trigger silencioso | silent-trigger | Los triggers deben coincidir con patrones de activación válidos y no causar fallos silenciosos. |
| Encabezados faltantes | missing-headers | El archivo SKILL.md debe contener al menos un encabezado de nivel 1 (#). |
Configuración
Puedes crear un archivo .doodlerc en la raíz de tu proyecto para personalizar las reglas:
{
"rules": {
"vague-description": "error",
"oversized-body": ["warn", { "maxLength": 1500 }],
"silent-trigger": "error",
"missing-headers": "off"
}
}
Ejemplos
Detectar una descripción vaga
Incorrecto:
# mi-skill
Hace cosas útiles.
Correcto:
# mi-skill
Esta habilidad automatiza el despliegue de aplicaciones Node.js en AWS Lambda.
Detectar un cuerpo sobredimensionado
Si el cuerpo del skill (después del título) excede el límite, doodle emitirá una advertencia o error.
Integración continua
Puedes integrar doodle en tu pipeline de CI/CD agregando un paso de linting:
# Ejemplo para GitHub Actions
- name: Lint SKILL.md
run: npx @krishyaid-coder/doodle lint .
Licencia
MIT