tzst

Visión general de la skill tzst

Qué te ayuda a hacer la skill tzst

La tzst skill es una guía práctica para usar la herramienta de línea de comandos tzst para crear, inspeccionar, probar y extraer archivos .tzst y .tar.zst. Resulta especialmente útil cuando ya sabes con qué rutas de archivos quieres trabajar y necesitas llegar más rápido al comando correcto, a los flags adecuados y a las opciones de seguridad, en lugar de depender de un prompt genérico.

Quién debería usar tzst

Esta tzst skill encaja bien para desarrolladores, perfiles de operaciones y quienes crean automatizaciones y necesitan flujos de trabajo fiables con archivos comprimidos en archivos locales, scripts, jobs de CI o tareas puntuales de soporte. Es especialmente relevante si buscas salida legible por máquinas, un comportamiento de extracción controlado o una vía de instalación clara y predecible.

Trabajo real que resuelve

La mayoría de usuarios no busca un recorrido por el repositorio. Lo que quiere es responder preguntas como: ¿Cómo instalo tzst? ¿Qué comando crea y cuál extrae? ¿Cómo evito sobrescribir archivos? ¿Cómo filtro lo que se extrae? ¿Cómo uso tzst para File Automation con una salida amigable para JSON y flags previsibles?

Diferenciadores clave

Frente a un prompt común, tzst es más específico y, por eso, más accionable. Se centra en la CLI, no en una API de Python; destaca opciones seguras por defecto; y orienta al usuario hacia patrones de comando concretos como a para crear, x para extracción estructurada, e para extracción plana, l para listar y t para probar el archivo.

Qué importa antes de instalar

Los mayores frenos de adopción suelen ser simples: si tzst ya está disponible en tu sistema, si prefieres una instalación basada en Python o un binario independiente, y si tu tarea realmente corresponde a tzst y no a tar o zip genéricos. Si lo que necesitas es manejo de archivos comprimidos desde la CLI, esta skill encaja muy bien. Si necesitas from tzst import ..., no es la guía principal adecuada.

Cómo usar la skill tzst

Empieza por la instalación y las comprobaciones previas

Antes de pedirle al modelo que haga algo importante, verifica que tzst existe en tu entorno:

tzst --version
tzst --help

Si no está instalado, la guía del repositorio apunta a estas rutas de instalación:

uv tool install tzst
pip install tzst

Si no quieres una instalación de Python, usa los binarios independientes publicados en https://github.com/xixu-me/tzst/releases/latest.

Cuándo conviene invocar la skill tzst

Usa la guía de tzst usage cuando la solicitud implique cualquiera de estos casos:

• crear un archivo .tzst
• extraer .tzst o .tar.zst
• aplanar el contenido extraído
• listar entradas del archivo
• comprobar la integridad del archivo
• elegir niveles de compresión
• usar modo streaming
• filtrar rutas al extraer
• seleccionar el comportamiento ante conflictos
• generar una salida adecuada para scripts

No recurras a esta skill como primera opción para formatos de archivo no relacionados o para preguntas sobre bibliotecas de Python.

Mapa básico de comandos

La forma más rápida de usar bien tzst es vincular tu objetivo al subcomando correcto:

• tzst a archive.tzst files... para crear
• tzst x archive.tzst para extraer conservando rutas
• tzst e archive.tzst para extracción plana
• tzst l archive.tzst para listar
• tzst t archive.tzst para probar

Esto importa porque muchos malos resultados vienen de elegir e cuando en realidad querías x, o de extraer sin pensar antes en los conflictos y en la ubicación de salida.

Para tzst, prioriza la extracción estructurada frente a la extracción plana

En flujos normales, tzst x es la opción más segura por defecto porque conserva la estructura de directorios. Usa tzst e solo cuando realmente quieras aplanar el contenido. Esta diferencia es importante para tzst for File Automation, donde aplanar puede provocar colisiones de nombres o dificultar la coincidencia de archivos en pasos posteriores.

Qué datos necesita de ti la skill tzst

Para generar un comando de alta calidad, la skill necesita detalles operativos concretos:

• ruta del archivo comprimido o nombre deseado del archivo de salida
• archivos o directorios de origen
• directorio de destino para la extracción
• si se desea aplanar el contenido
• si se permite sobrescribir
• cualquier filtro de rutas
• si la salida debe ser amigable para scripts
• si prefieres instalación con Python o binario independiente

Si omites estos datos, el modelo aún puede sugerir sintaxis, pero no podrá darte un comando de bajo riesgo.

Convierte un objetivo impreciso en un prompt sólido para tzst

Prompt débil:

Help me use tzst.

Prompt más sólido:

I need a tzst command to extract archive.tzst into ./out, preserve paths, avoid overwriting existing files, and only extract files under docs/. Assume tzst is already installed.

Por qué es mejor: le da a la skill el archivo, el destino, el modo de extracción, la expectativa de conflicto y el alcance del filtro en una sola pasada.

Patrón de prompt para crear archivos con tzst

Usa un prompt como este cuando vayas a crear archivos:

Give me a tzst create command for backup.tzst from ./src and ./docs, use a higher compression level, and explain any safety or performance tradeoffs.

Esto permite que la skill elija tzst a, saque a la luz -l o --level y aclare cuándo suelen bastar los valores por defecto y cuándo una compresión extra puede costar tiempo.

Patrón de prompt para scripting y automatización con tzst

Para tzst usage dentro de scripts de shell o CI, pide comandos con expectativas legibles por máquina:

I need tzst for File Automation in a CI job. Show commands to test an archive, list contents, and return output that is easy to parse in a script.

Esto orienta la skill hacia salidas pensadas para JSON o seguras para scripts cuando estén disponibles, y hacia secuencias de comandos estables en lugar de consejos interactivos.

Flujo de trabajo recomendado para tareas reales

Un flujo fiable es:

1. confirmar la instalación con tzst --version
2. comprobar la disponibilidad con tzst --help
3. elegir el subcomando según tu objetivo real
4. especificar destino, filtros y política de conflictos
5. listar o probar antes de una extracción destructiva cuando el riesgo sea alto
6. ejecutar el comando final
7. solo entonces integrarlo en una automatización

Esta secuencia reduce errores de extracción evitables y facilita la resolución de problemas.

Archivos del repositorio que merece la pena leer primero

Si quieres validar la skill antes de adoptarla, empieza aquí:

• skills/tzst/SKILL.md
• skills/tzst/references/cli-reference.md

SKILL.md te indica cuándo debería activarse la skill. references/cli-reference.md es el archivo más rápido para ver comandos de instalación, el mapa de comandos y la selección de flags.

Flags prácticos que sí cambian el resultado

Algunas opciones afectan materialmente al resultado:

• -l o --level cambia el nivel de compresión al crear
• -o controla el destino de extracción
• --streaming importa en flujos grandes o orientados a pipelines
• --filter limita qué se extrae
• --conflict-resolution ayuda a evitar sobrescrituras accidentales
• --no-atomic cambia el comportamiento de escritura durante la creación

No son flags cosméticos. Definen seguridad, rendimiento y comportamiento en scripts.

Errores habituales durante la instalación y el uso de tzst

Los errores más comunes son previsibles:

• intentar usar la skill para imports de Python en lugar de tareas de CLI
• saltarse las comprobaciones previas y descubrir que tzst no está instalado solo después de haber montado un flujo
• usar extracción plana cuando en realidad se quería conservar rutas
• no especificar el manejo de conflictos en directorios con archivos existentes
• pedir “un comando” sin indicar rutas, filtros ni salidas

Preguntas frecuentes sobre la skill tzst

¿La skill tzst es buena para principiantes?

Sí, si tu tarea es concreta. La tzst guide resulta más fácil para principiantes cuando ya saben qué archivo tienen y qué resultado quieren obtener. Ayuda menos en solicitudes vagas del tipo “enséñame sobre archivos comprimidos”.

¿Qué diferencia hay entre tzst y un prompt genérico de IA?

Un prompt genérico puede dar consejos plausibles sobre archivos comprimidos que no encajen con los subcomandos o flags de tzst. La tzst skill acota el modelo al flujo real de la CLI, a las opciones de instalación y al vocabulario de comandos que los usuarios realmente necesitan ejecutar.

¿Cuándo no debería usar tzst?

No uses tzst como guía principal para:

• preguntas genéricas sobre zip o tar sin relación con tzst
• uso de la API de Python, como from tzst import ...
• tareas de archivado en las que la herramienta realmente necesaria sea otra ya instalada

La skill está diseñada deliberadamente para la CLI.

¿Es adecuada tzst para automatización?

Sí. De hecho, es una de las razones más sólidas para usarla. La skill cubre explícitamente listado, pruebas, filtrado, control de conflictos y consideraciones sobre salida legible por máquinas, que son importantes en scripts de shell y en CI.

¿Cuál es la mejor vía de instalación de tzst?

Para muchos usuarios, uv tool install tzst es la instalación más limpia. pip install tzst funciona si las instalaciones de paquetes Python ya encajan con tu entorno. Si quieres la mínima sobrecarga de dependencias, el binario independiente es la mejor opción.

¿Necesito leer primero todo el repositorio?

No. Para decidir si instalarlo, normalmente solo necesitas SKILL.md y references/cli-reference.md. Con eso basta para evaluar el encaje, la cobertura de comandos y si la skill va a reducir la improvisación en tu caso de uso.

Cómo mejorar la skill tzst

Dale a tzst todo el contexto operativo

La forma más rápida de mejorar los resultados de tzst es aportar desde el principio detalles operativos concretos. Incluye el nombre del archivo, las rutas de origen, el directorio de destino, la política de sobrescritura, la preferencia por extracción plana o estructurada y si el comando debe ser seguro para scripting. Cuanto mejor sea la entrada, más probable es que obtengas un comando que puedas ejecutar tal cual.

Indica explícitamente tu tolerancia al riesgo

Si la tarea afecta a archivos importantes, dile a la skill si debe priorizar seguridad por encima de brevedad. Eso la empuja hacia listado, pruebas, extracción con conservación de rutas y configuración explícita de conflictos, en lugar de comandos mínimos.

Pide comando más justificación

Un buen formato de prompt es:

Give me the exact tzst command, explain each important flag briefly, and mention any safer alternative if the destination already contains files.

Esto mejora la confianza y te ayuda a detectar supuestos incorrectos antes de ejecutar nada.

Pide una iteración después del primer comando de tzst

La mejor forma de usar la tzst guide es de manera iterativa. Después de la primera respuesta, afínala con detalles de tu entorno:

Now adapt that command for a standalone binary install and a CI environment where the output must be easy to parse.

Esto suele ser más eficaz que empezar de cero.

Usa muestras de archivos y ejemplos de rutas

Si el filtrado o la extracción plana importan, incluye rutas representativas. Ejemplo:

Archive contains docs/api/index.md, docs/user/intro.md, and src/main.py. I only want docs/ extracted into ./site-content.

Ese nivel de detalle ayuda a la skill a elegir el modo de extracción correcto y el comportamiento de filtro adecuado.

Detecta pronto los fallos habituales

Pídele a la skill que revise estos puntos antes de cerrar un comando:

• falta de instalación de tzst
• subcomando incorrecto para la tarea
• aplanado accidental de rutas
• sobrescritura del archivo o conflictos durante la extracción
• supuestos no compatibles sobre el formato de salida

Aquí es donde la tzst skill aporta un valor real frente a una respuesta breve y genérica sobre CLI.

Mejora tzst para File Automation con flujos estables

Cuando uses tzst for File Automation, pide una secuencia en lugar de un solo comando: comprobaciones previas, listado o prueba, ejecución y verificación. La automatización estable suele venir de pasos previsibles, no de la sintaxis más corta posible.

Valida contra el archivo de referencia

Si un comando te genera dudas, compáralo con references/cli-reference.md. Ese archivo es la forma más rápida de verificar subcomandos, opciones de instalación y los flags con más probabilidades de afectar a la corrección.

Propón mejoras a la propia skill

Si detectas ambigüedades recurrentes, mejora la skill añadiendo más ejemplos orientados a la toma de decisiones sobre:

• x vs e
• valores por defecto seguros para conflict-resolution
• ejemplos de filtrado con rutas realistas
• patrones de salida orientados a automatización
• guía para elegir instalación con Python frente a binario independiente

Estas mejoras harían que la tzst skill fuese todavía más útil en el momento de decidir, no solo al ejecutar.