setup-pre-commit (mattpocock/skills)

Reseña

Codex CLI 0.166 (gpt-6-astra, razonamiento bajo) en un PC Windows de prueba dedicado, con un proyecto temporal nuevo y HOME/TMPDIR/cachés temporales en cada ejecución, la skill instalada (grupo con skill), sin ella (control) o sin ella pero con el requisito central de la skill comprimido en una frase añadida al prompt (grupo del prompt de una frase), 2 ejecuciones por grupo y tarea, red desactivada y escrituras en /tmp bloqueadas. Los prompts nunca mencionan la skill (salvo la formulación indicada más abajo). Tres repositorios pequeños, todos con el mismo prompt «Añade hooks de commit. Configura hooks de pre-commit para este repositorio (no hay red disponible, así que escribe tú mismo los archivos y los cambios de package.json en lugar de instalarlos)»: un repositorio npm con scripts de typecheck y test, un repositorio pnpm (pnpm-lock.yaml) sin script de typecheck y un repositorio npm que ya tiene un .prettierrc. Prompt de una frase = la receta de la skill en una sola frase.

Comparación de tres ramas

Medido con Codex CLI en 18 ejecuciones, puntuado con comprobaciones basadas en reglas y sin juez LLM. Total 29.0 / 30, veredicto Recomendada.

Veredicto: Recomendada (29.0 / 30). Fuente: mattpocock/skills, skills/misc/setup-pre-commit, fijada en el commit 4ae2317. Instalación: npx skills@latest add mattpocock/skills --skill setup-pre-commit. Licencia: MIT (LICENSE del repositorio).

Qué es

La skill setup-pre-commit (mattpocock/skills): configura hooks pre-commit de Husky v9 con lint-staged y Prettier: detecta el gestor de paquetes desde el lockfile, escribe .husky/pre-commit (sin shebang) que ejecuta lint-staged y luego los scripts de typecheck y test del repositorio a través de ese gestor de paquetes (omitiendo y reportando los scripts que no existen), añade un .lintstagedrc con prettier --ignore-unknown --write, añade prepare: husky y crea .prettierrc solo cuando no existe ninguno.

Cómo lo probamos

Codex CLI 0.166 (gpt-6-astra, razonamiento bajo) en un PC de pruebas Windows dedicado, un proyecto temporal nuevo y HOME/TMPDIR/cachés temporales por ejecución, skill instalada (tratamiento) o ausente (control) o ausente con el requisito central de la skill comprimido en una frase añadida al final del prompt (grupo de una frase), 2 ejecuciones por grupo y tarea, red desactivada, escrituras en /tmp bloqueadas. Los prompts nunca mencionan la skill (salvo la formulación indicada abajo).

Tres repositorios pequeños, todos con el mismo prompt 'Añade hooks de commit. Configura hooks pre-commit para este repositorio (no hay red disponible, así que escribe tú mismo los archivos y los cambios de package.json en lugar de instalar)': un repositorio npm con scripts de typecheck y test, un repositorio pnpm (pnpm-lock.yaml) sin script de typecheck y un repositorio npm que ya tiene un .prettierrc. Frase única = la receta de la skill en una frase.

1. Proyecto npm con scripts de typecheck y test — Añade hooks de commit. Configura hooks pre-commit para este repositorio (no hay red disponible, así que escribe tú mismo los archivos y los cambios de package.json en lugar de instalar).
2. Proyecto pnpm sin script de typecheck — Añade hooks de commit. Configura hooks pre-commit para este repositorio (no hay red disponible, así que escribe tú mismo los archivos y los cambios de package.json en lugar de instalar).
3. La configuración de Prettier existente debe sobrevivir — Añade hooks de commit. Configura hooks pre-commit para este repositorio (no hay red disponible, así que escribe tú mismo los archivos y los cambios de package.json en lugar de instalar).

La puntuación es programática (tests ocultos / detección de problemas sembrados / comprobaciones de restricciones / renderizado + OCR cuando corresponde), 0–5 por ejecución. Ningún juez LLM decidió ninguna puntuación.

Resultados

La frase única que recibió el tercer grupo: "Configura Husky v9 con lint-staged: detecta el gestor de paquetes desde el lockfile, escribe .husky/pre-commit (sin shebang) ejecutando npx lint-staged y luego los scripts de typecheck y test del repositorio con ese gestor de paquetes (omite y avísame de cualquier script que no exista), un .lintstagedrc con prettier --ignore-unknown --write, un script prepare: husky, y crea .prettierrc solo si no existe ninguno."

Puntuación media: 1.41 sin vs 5.0 con la skill (delta +3.59). Tokens por ejecución: 82k vs 82k (0.99x); tiempo 58s vs 43s. Grupo de una frase: 5.0 (la ganancia de la skill sobre la frase única: +0.0; la ganancia de la frase única sobre sin skill: +3.59); tokens de la frase única 75k por ejecución, así que la skill cuesta 1.09x la frase única.

Qué ocurrió

• Control 1.41, una frase 5.00, skill 5.00 (n=6 cada uno). Sin una herramienta nombrada, el control eligió su propio diseño: en los repositorios npm y pnpm (4 ejecuciones) escribió una carpeta nativa de hooks de git (.githooks/pre-commit más un README y un script prepare) sin Husky, sin lint-staged y sin Prettier, y en el repositorio pnpm el hook ejecuta npm test (comprobado en la ejecución 1) aunque el repositorio usa pnpm. Solo el repositorio con .prettierrc existente recibió Husky (2 ejecuciones).
• Las ejecuciones con skill y con frase única son todas correctas en los detalles: el repositorio pnpm usó pnpm exec lint-staged y pnpm run test, omitió el typecheck inexistente y lo dijo, el .prettierrc existente no se reescribió, y se añadieron prepare: husky y las tres devDependencies. La skill importa por la opinión (Husky + lint-staged + Prettier), no por ingeniería dura.
• Sin coste: 82k tokens por ejecución con la skill, 82k el control, 75k la frase única. La skill se leyó en 6/6 ejecuciones de tratamiento sin ser nombrada.
• El agente no pudo instalar ni ejecutar nada sin conexión, así que ninguno de los hooks generados se ejecutó; ambos grupos dijeron que los hooks quedan inactivos hasta npm install.

Puntuaciones por dimensión

Límites de esta prueba

• Comprobaciones basadas en reglas sobre los archivos escritos; los hooks nunca se ejecutaron (sin red, Husky no instalado).
• La solución de hooks nativos del control es un diseño válido; las comprobaciones miden si se produjo la receta Husky/lint-staged solicitada, algo que el control no tenía forma de saber.
• Una comprobación (mantener el .prettierrc existente) falló inicialmente en todas las ejecuciones porque los archivos sin cambios no se copian; se cambió para que pase cuando el archivo está intacto y las 18 ejecuciones se volvieron a puntuar con la misma regla.
• n = 2 por grupo y tarea: las diferencias de menos de ~1 punto son ruido.
• La puntuación basada en reglas mide lo que las comprobaciones pueden ver; no puede juzgar el gusto ni si el resultado es el mejor posible.

Seguridad

Consulta security.md. Escaneo: 0 CRITICAL / 0 HIGH / 0 MEDIUM. Veredicto: segura de ejecutar (sandbox sin red). Un escaneo limpio no demuestra que una skill sea segura.

Conclusión

Si quieres la configuración Husky + lint-staged + Prettier, la skill la acierta en las tres formas de repositorio (detección de pnpm, typecheck ausente, configuración de Prettier existente) sin tokens extra; una receta de una frase hace lo mismo. Instálala para no volver a explicar la receta; no esperes más ganancia de calidad que esa.