Communitygithub.com

xixu-me/skills

Habilidades de agente mantenidas por mí para trabajo práctico en ingeniería.

¿Qué es skills?

Esta habilidad está diseñada para que asistentes de IA como Claude Code, Cursor o Codex trabajen con la herramienta de línea de comandos `tzst`. Su propósito es guiar al agente para crear, extraer, listar y probar archivos `.tzst` (tar comprimido con zstd), siguiendo flujos de trabajo seguros y predecibles. La habilidad se activa cuando el usuario menciona `.tzst` o `.tar.zst`, o solicita operaciones como "crear archivo", "extraer respaldo" o "instalar tzst". Incluye pasos de pre-vuelo (verificar instalación, recomendar métodos de instalación con `uv`, `pip` o binarios independientes), reglas de selección de subcomandos (como preferir `x` sobre `e` para extracción plana), y valores predeterminados seguros como `--filter data` y la creación atómica de archivos. También cubre consideraciones para scripting, como el uso de `--json --no-banner`, códigos de salida y resolución explícita de conflictos en modo no interactivo. Errores comunes documentados incluyen confundir extracción plana con preservación de directorios o adivinar banderas basadas en `tar` en lugar de consultar la documentación empaquetada. Esta habilidad reemplaza el comportamiento genérico de `tar` y es esencial para cualquier desarrollador que automatice copias de seguridad o distribuciones con compresión de alta velocidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add xixu-me/skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Usa esta habilidad para la interfaz de línea de comandos tzst. Predetermina a ejecución cuando el usuario quiere claramente una acción real de archivo y las rutas o nombres de archivo necesarios ya se conocen.

Esta habilidad es solo para CLI. Si el usuario pregunta sobre código Python como from tzst import ..., trata eso como una tarea general de documentación de biblioteca o API de Python en lugar de usar esta habilidad como guía principal.

Cuándo Usar

Usa esta habilidad cuando el usuario:

  • mencione archivos .tzst o .tar.zst
  • quiera crear, extraer, aplanar, listar o probar un archivo tzst
  • necesite ayuda para instalar tzst o elegir banderas de CLI
  • quiera salida legible por máquina de tzst para scripting o automatización
  • necesite orientación segura para manejo de conflictos o filtros de extracción

No uses esta habilidad para preguntas genéricas sobre tar, zip o API de Python a menos que tzst sea realmente parte de la solicitud.

Verificación Prevuelo

  1. Verifica si tzst está disponible con tzst --version o tzst --help.
  2. Si falta, prefiere una de estas rutas de instalación:
  3. Vuelve a ejecutar tzst --version o tzst --help antes de hacer trabajo real.

Flujo de Trabajo

  1. Decide si la solicitud es ejecución u orientación. Solicitudes como "archivar estos archivos", "extraer este respaldo", "listar lo que contiene", "probar este archivo" o "instalar tzst" son intención de ejecución.
  2. Elige el comando que coincida con la solicitud:
    • a, add, create para creación de archivos
    • x, extract para extracción normal con preservación de la estructura de directorios
    • e, extract-flat solo cuando el usuario quiera explícitamente salida aplanada
    • l, list para inspección del archivo
    • t, test para comprobaciones de integridad
  3. Si el usuario quiere extraer solo unos pocos miembros y los nombres de los miembros son inciertos, lista primero.
  4. Carga references/cli-reference.md cuando necesites la matriz de comandos, nombres exactos de banderas o ejemplos para copiar y pegar.

Valores Predeterminados Seguros

  • Prefiere x sobre e a menos que se solicite explícitamente aplanamiento.
  • Mantén --filter data como el modo de extracción predeterminado.
  • Usa --filter tar solo cuando el usuario necesite compatibilidad estándar al estilo tar.
  • Usa --filter fully_trusted solo cuando el usuario diga explícitamente que la fuente del archivo es completamente confiable.
  • Mantén la creación atómica de archivos habilitada. Solo recurre a --no-atomic cuando el usuario quiera explícitamente.
  • Prefiere --streaming para archivos grandes o entornos con memoria limitada.
  • Para automatización o pipelines, prefiere tzst --json --no-banner ....
  • Para extracción automatizada, requiere una elección explícita no interactiva de --conflict-resolution como replace_all, skip_all o auto_rename_all.
  • No combines --json con solicitudes interactivas de conflictos.

Notas para Scripting

  • Pon las banderas globales antes del subcomando en ejemplos, como tzst --json --no-banner l archive.tzst.
  • Usa códigos de salida en scripts: 0 para éxito, 1 para errores de operación, 2 para errores de análisis de argumentos y 130 para interrupción.
  • Cuando la nomenclatura del archivo importe, informa al usuario que tzst puede normalizar un destino de creación a .tzst o .tar.zst.

Errores Comunes

  • Usar e cuando el usuario esperaba que se preservara la estructura de directorios original
  • Recomendar fully_trusted para archivos de una fuente desconocida o no confiable
  • Olvidar una estrategia explícita de conflictos para extracción no interactiva
  • Tratar una pregunta de API de Python como una pregunta de CLI
  • Adivinar banderas basadas en hábitos de tar en lugar de consultar la referencia empaquetada o la ayuda de CLI instalada

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

xixu-me/develop-userscripts

Use when building, debugging, packaging, or publishing browser userscripts for Tampermonkey or ScriptCat, including GM APIs, metadata blocks, permission issues, @match/@grant/@connect setup, ScriptCat background or scheduled scripts, UserConfig blocks, or subscription workflows.

xixu-me/github-actions-docs

Use when users ask how to write, explain, customize, migrate, secure, or troubleshoot GitHub Actions workflows, workflow syntax, triggers, matrices, runners, reusable workflows, artifacts, caching, secrets, OIDC, deployments, custom actions, or Actions Runner Controller, especially when they need official GitHub documentation, exact links, or docs-grounded YAML guidance.

xixu-me/openclaw-secure-linux-cloud

Use when self-hosting OpenClaw on a cloud server, hardening a remote OpenClaw gateway, choosing between SSH tunneling, Tailscale, or reverse-proxy exposure, or reviewing Podman, pairing, sandboxing, token auth, and tool-permission defaults for a secure personal deployment.

xixu-me/opensource-guide-coach

Use when a user wants guidance on starting, contributing to, growing, governing, funding, securing, or sustaining an open source project, or asks about contributor onboarding, community health, maintainer burnout, code of conduct, metrics, legal basics, or open source project adoption.

xixu-me/readme-i18n

Use when the user wants to translate a repository README, make a repo multilingual, localize docs, add a language switcher, internationalize the README, or update localized README variants in a GitHub-style repository.

xixu-me/running-claude-code-via-litellm-copilot

Use when routing Claude Code through a local LiteLLM proxy to GitHub Copilot, reducing direct Anthropic spend, configuring ANTHROPIC_BASE_URL or ANTHROPIC_MODEL overrides, or troubleshooting Copilot proxy setup failures such as model-not-found, no localhost traffic, or GitHub 401/403 auth errors.

xixu-me/secure-linux-web-hosting

Use when setting up, hardening, or reviewing a cloud server for self-hosting, including DNS, SSH, firewalls, Nginx, static-site hosting, reverse-proxying an app, HTTPS with Let's Encrypt or ACME clients, safe HTTP-to-HTTPS redirects, or optional post-launch network tuning such as BBR.

xixu-me/skills-cli

Use when users ask to discover, install, list, check, update, remove, back up, restore, sync, or initialize Agent Skills, mention `bunx skills`, `npx skills`, `skills.sh`, or `skills-lock.json`, ask "find a skill for X", or want help extending agent capabilities with installable skills.

xixu-me/tzst

Use when the user needs to create, extract, flatten, list, test, install, script, or troubleshoot `tzst` CLI workflows for `.tzst` or `.tar.zst` archives, including compression levels, streaming mode, extraction filters, conflict resolution, JSON output, or standalone binary setup, even if they describe the archive task without naming `tzst`.

xixu-me/use-my-browser

Use when work depends on the user's live browser session or visible rendered state rather than static fetches, especially for browser debugging contexts or DevTools-selected elements or requests, logged-in dashboards or CMS flows, localhost apps, forms, uploads, downloads, media inspection, DOM or iframe inspection, Shadow DOM, or browser failures that look like soft 404s, auth walls, anti-bot checks, or rate limits.

xixu-me/xdrop

Use this skill when the user wants to send or fetch files through an Xdrop server from the terminal, asks to automate encrypted Xdrop share-link workflows, provides an Xdrop `/t/:transferId#k=...` link to download and decrypt locally, or needs Xdrop CLI flags such as `--quiet`, `--json`, `--expires-in`, `--output`, or `--api-url`, even if they do not explicitly mention the skill name.

xixu-me/xget

Use when tasks involve Xget URL rewriting, registry/package/container/API acceleration, integrating Xget into Git, download tools, package managers, container builds, AI SDKs, CI/CD, deployment, self-hosting, or adapting commands and config from the live README `Use Cases` section into files, environments, shells, or base URLs.

Skills relacionados