HumanLayer Skills: conservar instrucciones y diseñar ciclos revisables
Probar limpieza de instrucciones HumanLayer con comandos protegidos
Evalúa una propuesta CLAUDE.md con datos sintéticos, comandos conservados y restricciones explícitas antes de cambiar orientación persistente.
Qué aprenderás
- Prepara una fuente cuyo significado puedas comprobar
- Revisa eliminaciones tanto como formato
- Mide el beneficio conductual por separado
Antes de empezar
- Instrucciones de repositorio y conceptos GitHub Actions
- Comprender alcance de revisión y contexto persistente
Diseñar un flujo acotado e inspeccionable y separar supuestos de plantillas de comportamiento probado.
Conclusiones clave
- Protege comandos y restricciones importantes antes de reescribir.
- No supongas que un linter aplica cada regla documentada.
- Conservación estructural y adherencia son pruebas diferentes.
Prepara una fuente cuyo significado puedas comprobar
Crea una guía sintética con identidad, mapa pequeño, comandos de construcción y pruebas y una regla específica. Añade una restricción protegida como revisar antes de publicar. Conserva el original y pide solo una propuesta, no editar instrucciones activas del repositorio.
improve-claude-md mantiene contexto fundamental sin envoltura, agrupa comandos y coloca orientación específica en bloques important condicionales. Exige conservar todos los comandos originales. Son propiedades comprobables sin haber demostrado todavía una mejora de comportamiento del modelo.
Revisa eliminaciones tanto como formato
La habilidad propone quitar reglas impuestas por linters, fragmentos obsoletos e instrucciones vagas. Aplica criterio: no borres restricciones de seguridad o publicación por parecer reglas de proceso. Comprueba que la supuesta validación existe y se ejecuta antes de llamar redundante a su documentación.
Compara comandos, restricciones, reglas movidas y texto eliminado. Un archivo más corto puede ser peor si pierde un comando de migración raro pero importante. Conservar un comando documentado no concede permiso para ejecutarlo durante el ejercicio.
Mide el beneficio conductual por separado
Tras aceptar la estructura, una prueba controlada posterior puede comparar tareas con la guía original y revisada. Mantén modelo, entrada y aceptación constantes y registra incumplimientos. Bloques con aspecto XML válido no prueban semántica especial del anfitrión.
No editamos CLAUDE.md ni AGENTS.md de este workspace y no ejecutamos esa prueba de modelo. El ejercicio prioriza conservación y alcance. Cualquier afirmación de mejor adherencia debe venir de medición, no de un documento visualmente más ordenado.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Prepara instrucciones sintéticas y elementos protegidos.
- 2
Solicita propuesta sin aplicarla.
- 3
Compara comandos, restricciones y eliminaciones.
- 4
Mide adherencia en una prueba aparte.
Ejemplo para copiar
{
"ejercicio": true,
"comandosOriginales": [
"npm run build",
"npm test",
"npm run migrate:review"
],
"reglasProtegidas": [
"Revisar antes de publicar"
],
"ejecutarComandos": false,
"aplicarReescritura": false
}Preguntas frecuentes
¿Hay que ejecutar los comandos conservados?
No. Documentarlos no autoriza ejecutarlos.
¿Los bloques important garantizan cumplimiento?
Esta revisión no establece tal garantía.
Fuentes
- HumanLayer Skills / plugins/improve-claude-md/skills/improve-claude-md/SKILL.mdFuente verificada 2026-09-14