Compact Docs Writer
Reduce la documentación controlada por versiones leída por agentes para la economía de tokens sin omitir ninguna regla, mostrada como un diff.
Probado · Funciona
Qué hace
Reescribe o redacta un documento (ej. CONTRIBUTING.md, CLAUDE.md, un archivo de skill) para que contenga cada regla y restricción con la menor cantidad de palabras posible, ya que estos documentos son releídos por los agentes en cada sesión. Aplica una prueba no-op para justificar cada eliminación, colapsa conceptos recurrentes en 'palabras clave' únicas, y presenta el resultado como un diff cercado con un delta de palabras/tokens medido con `wc -w` en lugar de estimado, aplicando solo después de aprobación explícita. Omite explícitamente documentos desechables como planes únicos.
Informe de la prueba
Upstream de hecho cambió el día de nuestra prueba (commit 'improve self-test', 2026-07-16 14:32), pero el diff muestra que es una actualización de versión 1.4 → 1.5 más un elemento de auto-revisión añadido: 'addition audit' — cada frase añadida ahora también debe pasar una prueba no-op. Esto es un endurecimiento de un procedimiento existente, no una solución a un problema o un nuevo riesgo, por lo que el veredicto de aprobación se mantiene. Se volvió a ejecutar el protocolo desde cero en la nueva versión: el comando de instalación funciona al pie de la letra, frontmatter analizado (name, description, allowed-tools, license), la skill no extrae ningún archivo externo, Etapa 0 limpia — sin scripts, red ni instrucciones ocultas. Prueba A/B en vivo en un documento de reglas de revisión de código expandido (319 palabras, medido con wc -w): la línea base se comprimió a 70 palabras pero eliminó silenciosamente la justificación de tres reglas (por qué el revisor del equipo propietario, por qué 24 horas para responder, por qué el límite de 400 líneas), mientras que la ejecución con el cuerpo de la skill arrojó 117 palabras y conservó las ocho reglas y su 'por qué'. Mismo patrón que la última vez: la línea base es más corta, la skill es la única que no pierde la intención.
Probado el: 2026-07-16 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/FrancescoBorzi/agent-toolkit.git mkdir -p ~/.claude/skills cp -r agent-toolkit/skills/compact-docs-writer ~/.claude/skills/compact-docs-writer
Comandos y prompts de ejemplo
/compact-docs-writerReduce la documentación controlada por versiones leída por agentes para la economía de tokens sin omitir ninguna regla, mostrada como un diff.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
shrink this CONTRIBUTING.md without losing any of the actual rulesmake my CLAUDE.md shorter but keep the reasoning behind each ruleshow me a diff of the token savings after trimming this doc