Habilidades caveman-compress

caveman-compress

Riesgo bajo ⚙️ Comandos externos🔑 Variables de entorno

Comprime archivos de memoria para reducir costos de tokens

Archivos de memoria grandes como CLAUDE.md desperdician tokens al inicio de cada sesión de IA. Esta habilidad los comprime aproximadamente un 46 por ciento manteniendo intacto todo el contenido técnico.

Soporta: Claude Codex Code(CC)
🥉 75 Bronce
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "caveman-compress". Un archivo CLAUDE.md de 706 tokens con preferencias de TypeScript, pautas de prueba y convenciones de proyecto escritas en prosa completa.

Resultado esperado:

Una versión comprimida de 285 tokens que preserva todas las instrucciones técnicas en prosa directa estilo cavernícola. Los encabezados, ejemplos de código y URLs permanecen sin cambios. Original guardado como CLAUDE.original.md.

Usando "caveman-compress". Un archivo de notas de proyecto de 1145 tokens con descripciones de arquitectura, pasos de implementación y convenciones de equipo.

Resultado esperado:

Un archivo comprimido de 535 tokens. Todos los encabezados de sección preservados exactamente. Bloques de código y URLs intactos. Explicaciones redundantes condensadas a hechos esenciales. Respaldo guardado como project-notes.original.md.

Auditoría de seguridad

Riesgo bajo
v1 • 4/15/2026

Static analysis flagged 107 potential issues across 10 files with a risk score of 100/100. After semantic evaluation, all flagged patterns are false positives. The external_commands findings (74 locations) are primarily markdown backticks in documentation files misidentified as shell execution. The one real subprocess call in scripts/compress.py uses hardcoded arguments with stdin input and no shell interpolation. Network findings (2 locations) are static URLs in README.md documentation, not runtime requests. Filesystem findings (2 locations) are standard path resolution for a file-processing tool. Environment access findings (9 locations) are legitimate ANTHROPIC_API_KEY and CAVEMAN_MODEL configuration for API usage. The critical heuristic finding about code execution plus network plus credential access is a false positive describing the normal operation of an Anthropic API client. No prompt injection attempts, data exfiltration patterns, or malicious intent detected. The tool has appropriate safeguards including file size limits (500KB), automatic backups, and retry logic with rollback on failure.

10
Archivos escaneados
964
Líneas analizadas
5
hallazgos
1
Auditorías totales
Problemas de riesgo bajo (3)
Subprocess CLI Call
The tool calls the claude CLI via subprocess.run as a fallback when ANTHROPIC_API_KEY is not set. Arguments are hardcoded and user content is passed via stdin, not shell arguments. This is a standard pattern for Claude CLI integration. The risk is minimal but warrants documentation.
Environment Variable Access for API Key
The tool reads ANTHROPIC_API_KEY from environment variables to authenticate with the Anthropic API. This is standard and expected behavior for API tooling. The key is used only for direct API calls to Anthropic, not transmitted elsewhere.
File Write to User-Specified Path
The tool writes compressed content back to the same file path the user specifies. A backup is created before overwriting. The path is resolved to an absolute path and validated for existence and size (max 500KB). No files outside the user-specified path are modified.

Factores de riesgo

⚙️ Comandos externos (1)
🔑 Variables de entorno (1)
Auditado por: claude

Puntuación de calidad

59
Arquitectura
100
Mantenibilidad
87
Contenido
50
Comunidad
84
Seguridad
83
Cumplimiento de la especificación

Lo que puedes crear

Reduce los costos recurrentes de sesión

Comprime tu archivo de memoria de proyecto CLAUDE.md una vez. El archivo más pequeño se carga en cada inicio de sesión, ahorrando tokens cada vez que trabajas con IA.

Optimiza la documentación del equipo

Comprime archivos de preferencias compartidas, guías de estilo y convenciones de proyecto. Los miembros del equipo obtienen las mismas instrucciones con menos tokens de entrada por sesión.

Condensa notas de proyectos a largo plazo

Comprime listas de tareas acumuladas, notas de reuniones y registros de decisiones en hechos esenciales. Mantén toda la información sin el exceso verbal.

Prueba estos prompts

Comprime un solo archivo
Comprime el archivo en CLAUDE.md al formato cavernícola.
Comprime múltiples archivos de preferencias
Comprime estos archivos de memoria: CLAUDE.md, todos.md y preferences.txt.
Recomprime después de editar
Actualicé CLAUDE.original.md con nuevos estándares de codificación. Compímelo de nuevo para reemplazar CLAUDE.md.
Comprime con modelo personalizado
Establece CAVEMAN_MODEL en claude-haiku y comprime CLAUDE.md.

Mejores prácticas

  • Edita el archivo de respaldo .original.md, luego recomprime. Esto mantiene tu fuente de verdad en formato legible por humanos.
  • Ejecuta la compresión después de actualizaciones mayores a los archivos de memoria. Las ediciones frescas a menudo agregan explicaciones verbosas que se comprimen bien.
  • Revisa la salida comprimida antes de confiar en ella. Las verificaciones validan el contenido técnico pero los cambios de estilo pueden afectar matices.

Evitar

  • No comprimas archivos de código, archivos de configuración o cualquier archivo con contenido principalmente de código. La herramienta los omitirá automáticamente.
  • No elimines el respaldo .original.md. Es tu fuente legible por humanos y punto de recuperación.
  • No ejecutes compresión repetidamente en archivos sin cambios. Cada ejecución consume tokens de API. Comprime solo después de ediciones significativas.

Preguntas frecuentes

¿Qué pasa con mi archivo original?
Tu archivo original se sobrescribe con la versión comprimida. Antes de que eso suceda, se guarda un respaldo con la extensión .original.md. Siempre puedes leer o editar el respaldo.
¿Puedo comprimir archivos además de CLAUDE.md?
Sí. Cualquier archivo markdown (.md), texto plano (.txt) o reStructuredText (.rst) funciona. Los archivos sin extensión que contienen lenguaje natural también son compatibles. Los archivos de código y configuración se omiten automáticamente.
¿La compresión pierde información técnica?
No. Los bloques de código, URLs, rutas de archivo, comandos y términos técnicos se preservan exactamente. El paso de validación verifica encabezados, bloques de código, URLs y estructura después de la compresión. Si la validación falla, la herramienta reintentará con correcciones específicas.
¿Qué pasa si la compresión falla o produce mala salida?
La herramienta reintentará hasta 2 veces con correcciones específicas. Si todos los reintentos fallan, tu archivo original se restaura y se deja intacto. El respaldo solo se mantiene en compresión exitosa.
¿Cuántos tokens ahorra la compresión?
En promedio, se ahorra aproximadamente el 46 por ciento de los tokens de entrada. Los archivos individuales van de 36 a 60 por ciento de ahorro dependiendo de cuán verboso sea el texto original.
¿Necesito una clave de API de Anthropic para usar esta habilidad?
Sí, ya sea ANTHROPIC_API_KEY establecido en tu entorno, o la CLI de claude instalada con autenticación de escritorio configurada. La habilidad usa lo que esté disponible.

Detalles del desarrollador

Estructura de archivos