skillcheck: Un linter para archivos SKILL.md que detecta problemas de compatibilidad entre agentes.
Qué hace skillcheck
skillcheck es un linter para archivos SKILL.md que valida según la especificación de agentskills.io. Fue creado después de encontrar problemas donde habilidades escritas para Claude Code no se cargaban en VS Code debido a campos name no coincidentes y otros problemas de compatibilidad entre agentes.
Características principales
- Puntúa la calidad de la descripción de 0 a 100 para descubribilidad (los agentes usan este campo para decidir si activar una habilidad)
- Advierte sobre campos que solo funcionan en Claude Code y no funcionarán en VS Code, Codex o Cursor
- Verifica que las referencias a archivos en el cuerpo de SKILL.md apunten a archivos que existen en el disco
- Valida presupuestos de tokens de divulgación progresiva de la especificación
- Proporciona salida JSON y códigos de salida para integración en CI
- Incluye una GitHub Action
Instalación y uso
Instalar mediante pip: pip install skillcheck
Ejecútalo apuntando a un archivo o directorio: skillcheck ruta/al/skill.md o skillcheck ruta/al/directorio/de/habilidades
Detalles técnicos
- Construido con Python 3.10+
- Solo una dependencia: PyYAML
- Licencia MIT
- Construido con ayuda de Claude y VS Code
Comparación con herramientas existentes
El creador leyó el código fuente de cada validador existente antes de construir skillcheck, incluyendo skills-ref, cclint, skills-cli y quick_validate.py de Anthropic. La puntuación de descripción, las advertencias entre agentes y las verificaciones de referencias de archivos no existen en ninguna de estas herramientas existentes. Algunas validaciones de frontmatter se superponen con validadores existentes.
📖 Leer la fuente completa: r/ClaudeAI
👀 Ver también
Desarrollo Guiado por Manual: Un Método para Prevenir la Divergencia Confiada del Código de Claude
El Desarrollo Guiado Manual (MDD) es un método que aborda la divergencia confiada en Claude Code, donde la IA produce código incorrecto que pasa sus propias pruebas. En una auditoría de producción, MDD encontró 190 problemas, escribió 876 pruebas nuevas en menos de 8 horas y eliminó violaciones de reglas.
Session Inspector para Claude Code proporciona visibilidad en tiempo real de las operaciones de agentes de IA.
Vibeyard, un IDE de terminal de código abierto que envuelve Claude Code, ha añadido una función de Inspector de Sesión que proporciona visibilidad en tiempo real de las sesiones de Claude Code con seguimiento de línea de tiempo, desglose de costos, análisis de herramientas y monitoreo de ventana de contexto.
Script de Python de 80 líneas usa Claude para generar sugerencias de enlaces internos automáticamente, reduciendo el tiempo de enlace de 2 horas a 8 minutos
Un usuario de Reddit creó un script de Python de 80 líneas que alimenta a Claude con un borrador de artículo y un mapa del sitio, obteniendo enlaces internos relevantes con texto ancla sugerido, reduciendo el tiempo de enlazado manual de 2 horas a 8 minutos por artículo.
Escalando la Investigación Automatizada de Karpathy con 16 GPUs: Resultados y Métodos
El equipo de SkyPilot le dio a Claude Code acceso a 16 GPUs en un clúster de Kubernetes para ejecutar el proyecto Autoresearch de Karpathy. En 8 horas, el agente envió ~910 experimentos, redujo los bits por byte de validación de 1.003 a 0.974 (una mejora del 2.87%), y alcanzó la mejor pérdida de validación 9 veces más rápido que la ejecución secuencial.