Skill: file-compress
When to Use
Use this skill when the user asks to:
- Zip or compress files/folders
- Unzip or extract an archive
- Create a ZIP or tar.gz archive
- List contents of an archive
- Compress files for sharing or backup
Supported Formats
| Format | Extensions | Notes |
|---|---|---|
| ZIP | .zip | Most common, cross-platform |
| Gzipped Tar | .tar.gz, .tgz | Unix standard, preserves permissions |
Input Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
action | Yes | create, extract, or list | create |
archive_path | Yes | Path to the archive file | ./backup.zip |
files | For create | Files/directories to include | file1.txt dir/ |
target_dir | For extract | Directory to extract to (default: current) | ./output/ |
format | For create | zip (default) or tar.gz | zip |
Procedure
-
Determine the action from the user's request
-
Run the bundled script:
# Create a ZIP archive python3 skills/file-compress/scripts/archive.py create backup.zip file1.txt file2.txt mydir/ # Create a tar.gz archive python3 skills/file-compress/scripts/archive.py create backup.tar.gz --format tar.gz file1.txt mydir/ # Extract an archive python3 skills/file-compress/scripts/archive.py extract backup.zip --target ./output/ # List archive contents python3 skills/file-compress/scripts/archive.py list backup.zip -
Report the result to the user
Bundled Scripts
| Script | Type | Description |
|---|---|---|
scripts/archive.py | Python | Create, extract, and list ZIP/tar.gz archives |
Script Usage
# Create ZIP from files and directories
python3 scripts/archive.py create output.zip file1.txt file2.txt mydir/
# Create tar.gz
python3 scripts/archive.py create output.tar.gz --format tar.gz src/ README.md
# Extract to current directory
python3 scripts/archive.py extract archive.zip
# Extract to specific directory
python3 scripts/archive.py extract archive.tar.gz --target /tmp/extracted/
# List contents
python3 scripts/archive.py list archive.zip
Example
zip up the src/ folder
create a tar.gz of these files
extract backup.zip to my desktop
what's inside archive.tar.gz
compress the project folder into a zip
unzip downloaded-file.zip