archive-extraction-safety
Installation
SKILL.md
Archive Extraction Safety
Use this skill for static review or design of code that extracts archive entries into a destination directory. The goal is to make extraction safe before any archive-controlled path, metadata, file type, permission, ownership, or decompressed content reaches the filesystem.
Trigger Conditions
- ZIP, TAR, tar.gz, tgz, package, backup, artifact, plugin, theme, or import flows that unpack files.
- Code or designs that validate archive entry names, then write them to disk.
- Reviews of Zip Slip / Tar Slip, symlink, hardlink, absolute-path, Windows path, Unicode normalization, decompression-bomb, nested-archive, overwrite, or partial-extraction cleanup risks.
- Tests for archive extraction policy, parser consistency, decompressed size limits, file count limits, compression-ratio limits, and destination containment.
Do NOT use this skill for:
- Pure archive download or outbound URL validation with no extraction.
- General filesystem path construction after extraction has already produced trusted, validated paths.
- Archive creation, compression tuning, or backup retention with no untrusted archive input.
- Live execution against untrusted archives. Prefer inert excerpts, fixture manifests, and static reasoning.