Communitygithub.com

xixu-me/skills - tzst CLI 도구

실용적인 엔지니어링 작업을 위한 `tzst` 명령줄 인터페이스 스킬입니다.

skills - tzst CLI 도구란 무엇인가요?

이 스킬은 `.tzst` 및 `.tar.zst` 아카이브를 위한 `tzst` 명령줄 도구를 안내하고 실행하는 데 초점을 맞춥니다. 사용자가 아카이브 생성, 추출, 플래트닝, 목록 보기, 무결성 검사 등 구체적인 작업을 요청할 때 기본적으로 실행을 지향합니다. Python 라이브러리 API 질문(`from tzst import ...`)은 CLI 사용 가이드와 분리하여 일반적인 문서화 작업으로 처리합니다. 시작하기 전에 `tzst`가 설치되어 있는지 확인하고, 없으면 `uv tool install tzst`, `pip install tzst`, 또는 독립 실행형 바이너리를 통해 설치를 안내합니다. 워크플로는 요청을 실행 의도(아카이브 작업)와 안내 의도(도움말)로 구분하고, `a`, `x`, `e`, `l`, `t` 같은 하위 명령을 선택합니다. 안전 기본값으로 `--filter data` 추출, 원자적 아카이브 생성, 스트리밍 모드를 권장하며, 자동화 파이프라인에는 `--json` 및 `--no-banner` 플래그와 명시적인 충돌 해결 전략이 필요합니다. 참조 CLI 문서(`references/cli-reference.md`)를 활용하여 정확한 플래그와 예제를 확인하고, `tar` 습관에서 추측하지 않도록 주의합니다. 일반적인 실수로는 플래트닝(`e`)과 일반 추출(`x`) 혼동, 신뢰할 수 없는 아카이브에 `fully_trusted` 필터 사용, 비대화형 추출에서 충돌 전략 누락 등이 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add xixu-me/skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

tzst 명령줄 인터페이스용 스킬입니다. 사용자가 실제 아카이브 작업을 원하고 필요한 경로나 아카이브 이름이 이미 알려진 경우 기본적으로 실행합니다.

이 스킬은 CLI 전용입니다. 사용자가 from tzst import ...와 같은 Python 코드를 묻는 경우, 이 스킬을 주요 가이드로 사용하지 말고 일반 Python 라이브러리 또는 API 문서화 작업으로 처리하십시오.

사용 시기

다음과 같은 경우 이 스킬을 사용하십시오:

  • .tzst 또는 .tar.zst 아카이브를 언급할 때
  • tzst 아카이브를 생성, 추출, 플래트닝, 목록 보기, 또는 테스트하려고 할 때
  • tzst 설치 또는 CLI 플래그 선택에 도움이 필요할 때
  • 스크립팅 또는 자동화를 위해 기계가 읽을 수 있는 tzst 출력이 필요할 때
  • 안전한 충돌 처리 또는 추출 필터 지침이 필요할 때

tzst가 실제로 요청의 일부가 아닌 경우 일반 tar, zip 또는 Python API 질문에 이 스킬을 사용하지 마십시오.

사전 확인

  1. tzst --version 또는 tzst --help로 tzst를 사용할 수 있는지 확인하십시오.
  2. 누락된 경우 다음 설치 경로 중 하나를 권장하십시오:
  3. 실제 작업을 수행하기 전에 tzst --version 또는 tzst --help를 다시 실행하십시오.

워크플로

  1. 요청이 실행인지 안내인지 결정하십시오. "이 파일들을 아카이브", "이 백업 추출", "내부 내용 목록 보기", "이 아카이브 테스트", 또는 "tzst 설치"와 같은 요청은 실행 의도입니다.
  2. 요청에 맞는 명령을 선택하십시오:
    • a, add, create: 아카이브 생성
    • x, extract: 디렉터리 구조를 유지하는 일반 추출
    • e, extract-flat: 사용자가 명시적으로 플래트닝된 출력을 원할 때만
    • l, list: 아카이브 검사
    • t, test: 무결성 검사
  3. 사용자가 일부 멤버만 추출하려고 하고 멤버 이름이 불확실하면 먼저 목록을 보십시오.
  4. 명령 매트릭스, 정확한 플래그 이름, 또는 복사-붙여넣기 예제가 필요하면 references/cli-reference.md를 참조하십시오.

안전 기본값

  • 플래트닝이 명시적으로 요청되지 않는 한 e보다 x를 선호하십시오.
  • 기본 추출 모드로 --filter data를 유지하십시오.
  • 사용자가 표준 tar 스타일 호환성이 필요할 때만 --filter tar를 사용하십시오.
  • 사용자가 아카이브 소스를 완전히 신뢰한다고 명시적으로 말할 때만 --filter fully_trusted를 사용하십시오.
  • 원자적 아카이브 생성을 활성화된 상태로 유지하십시오. 사용자가 명시적으로 원할 때만 --no-atomic을 사용하십시오.
  • 대용량 아카이브 또는 메모리 제한 환경에서는 --streaming을 선호하십시오.
  • 자동화 또는 파이프라인에서는 tzst --json --no-banner ...를 선호하십시오.
  • 자동화된 추출의 경우 replace_all, skip_all, 또는 auto_rename_all과 같은 명시적인 비대화형 --conflict-resolution 선택이 필요합니다.
  • --json을 대화형 충돌 프롬프트와 결합하지 마십시오.

스크립팅 참고 사항

  • 예제에서는 tzst --json --no-banner l archive.tzst와 같이 전역 플래그를 하위 명령 앞에 두십시오.
  • 스크립트에서 종료 코드를 사용하십시오: 0은 성공, 1은 작업 오류, 2는 인수 구문 분석 오류, 130은 중단입니다.
  • 아카이브 이름 지정이 중요한 경우, tzst가 생성 대상을 .tzst 또는 .tar.zst로 정규화할 수 있다고 사용자에게 알리십시오.

일반적인 실수

  • 사용자가 원래 디렉터리 구조가 보존되기를 기대할 때 e를 사용하는 경우
  • 알 수 없거나 신뢰할 수 없는 소스의 아카이브에 fully_trusted를 권장하는 경우
  • 비대화형 추출에 명시적인 충돌 전략을 잊어버리는 경우
  • Python API 질문을 CLI 질문으로 처리하는 경우
  • 번들된 참조 또는 설치된 CLI 도움말을 확인하지 않고 tar 습관에서 플래그를 추측하는 경우

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.

관련 스킬