audit

Resumen

¿Qué es la skill audit?

La skill audit está diseñada para desarrolladores frontend y equipos que necesitan evaluar sistemáticamente la calidad técnica de su base de código. Revisa accesibilidad (A11y), rendimiento, consistencia en temas, diseño responsivo y patrones contraproducentes comunes. La skill genera un informe puntuado con niveles de severidad (P0-P3) y planes de acción, ayudándote a priorizar mejoras y mantener altos estándares.

¿Quién debería usar audit?

• Ingenieros frontend que buscan validar la calidad del código
• Equipos de QA enfocados en accesibilidad y rendimiento
• Líderes de proyecto preparando cumplimiento o lanzamiento
• Cualquier persona que necesite una auditoría estructurada a nivel de código (no una crítica de diseño)

Problemas que resuelve

• Identifica brechas de accesibilidad (contraste, ARIA, navegación por teclado, HTML semántico, texto alternativo, formularios)
• Señala cuellos de botella en rendimiento
• Destaca problemas de temas y diseño responsivo
• Detecta patrones contraproducentes y deuda técnica
• Proporciona niveles claros de severidad y pasos a seguir

Cómo usar

Pasos de instalación

1. Instala la skill audit usando:

   npx skills add https://github.com/pbakaus/impeccable --skill audit
   

2. Revisa el archivo SKILL.md para instrucciones detalladas y criterios de puntuación.

Preparación

• Antes de ejecutar audit, invoca /frontend-design para recopilar contexto de diseño y patrones contraproducentes. Si no existe contexto de diseño, ejecuta primero /teach-impeccable.
• La skill audit se enfoca en aspectos técnicos medibles; no corrige problemas, sino que los documenta para seguimiento.

Ejecutando la auditoría

• Usa la skill para escanear tu base de código frontend. Revisa cinco dimensiones clave:
  • Accesibilidad (A11y)
  • Rendimiento
  • Temas
  • Diseño responsivo
  • Patrones contraproducentes
• Cada dimensión se puntúa de 0 (problemas críticos) a 4 (cumplimiento excelente).
• El resultado es un informe completo con niveles de severidad (P0-P3) y recomendaciones prácticas.

Estructura de archivos y revisión

• Comienza con SKILL.md para detalles del flujo de trabajo y puntuación.
• Explora archivos complementarios como README.md, AGENTS.md, metadata.json y carpetas como rules/, resources/, references/ o scripts/ para contexto adicional.

Preguntas frecuentes

¿Es audit adecuado para revisiones de diseño?

No. La skill audit realiza chequeos técnicos a nivel de código. Para críticas de diseño, usa /frontend-design u otras skills relacionadas.

¿Qué incluye el informe de audit?

El informe cubre accesibilidad, rendimiento, temas, diseño responsivo y patrones contraproducentes, cada uno puntuado y priorizado según severidad.

¿Puede audit corregir problemas automáticamente?

No. Audit documenta problemas y ofrece planes de acción. Usa otras skills o correcciones manuales para resolver los hallazgos.

¿Dónde encuentro los criterios de puntuación?

Los detalles y listas de verificación están en SKILL.md. Abre la pestaña de Archivos para ver el árbol completo y scripts auxiliares.

¿Cuándo debo usar audit?

Usa audit antes de lanzamientos, revisiones de cumplimiento o como parte de revisiones regulares de calidad de código para asegurar que tu frontend cumple con los estándares técnicos.