Skip to content
Skills Library
Programming · Conversion & formats

github-publish-zip

/github-publish-zip

Create a ZIP archive from the files in a Git worktree that would be publishable to GitHub, using configurable compression backend priority. Use when the user asks to package, archive, zip, or prepare a repository for GitHub publication while respecting project and user ignore rules, excluding .git metadata, and writing the archive to the project's local directory.

Licence
GPL-3.0
Last repository change
17.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 17.09.2026, without references to retired models or APIs.

Licence

GPL-3.0, otwarta.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/pack_github_publish_zip.py

What it does and when to use it

Create a ZIP archive from the files in a Git worktree that would be publishable to GitHub, using configurable compression backend priority. Use when the user asks to package, archive, zip, or prepare a repository for GitHub publication while respecting project and user ignore rules, excluding .git metadata, and writing the archive to the project's local directory.

Original author description

Create a ZIP archive from the files in a Git worktree that would be publishable to GitHub, using configurable compression backend priority. Use when the user asks to package, archive, zip, or prepare a repository for GitHub publication while respecting project and user ignore rules, excluding .git metadata, and writing the archive to the project's local directory.

How it works

  1. Workflow
  2. Compression Priority
  3. Boundary Rules
  4. Verification
Original SKILL.md headings · 76 lines, 346 words
SKILL.md preview
---
name: github-publish-zip
description: Create a ZIP archive from the files in a Git worktree that would be publishable to GitHub, using configurable compression backend priority. Use when the user asks to package, archive, zip, or prepare a repository for GitHub publication while respecting project and user ignore rules, excluding .git metadata, and writing the archive to the project's local directory.
metadata:
  version: "0.1"
  updated: "2026-06-21"
---

# GitHub Publish Zip

## Workflow

Use `scripts/pack_github_publish_zip.py` from this skill. Prefer passing the target project path explicitly:

```bash
python3 /path/to/github-publish-zip/scripts/pack_github_publish_zip.py /path/to/project
```

Run a dry run first when the target repository is large or the user asks to inspect scope:

```bash
python3 /path/to/github-publish-zip/scripts/pack_github_publish_zip.py /path/to/project --dry-run --list-files
```

The script:

- Finds the Git top-level directory from the supplied path or current directory.
- Builds the file list with `git ls-files --cached --others --exclude-standard --deduplicate`.
- Uses the working tree contents, including tracked modifications and untracked files that are not ignored.
- Respects `.gitignore`, `.git/info/exclude`, and user/global Git ignore rules.
- Excludes `.git` metadata, the output archive, and the configured output directory contents.
- Creates the project `local/` directory when needed.
- Writes `<project-name>-YYYYMMDD-hhmm.zip` under `local/`.
- Uses compression backend priority and reports the actual backend used.

## Compression Priority

Default priority is:

```text
zip,7z,python
```

This means: use system `zip -9` first, then system `7z`, then Python `zipfile` as the last fallback.

For maximum compression preference, use:

```bash
python3 /path/to/github-publish-zip/scripts/pack_github_publish_zip.py /path/to/project --max-compression
```

`--max-compression` changes the default priority to:

```text
7z,zip,python
```

To make the priority explicit, pass:

```bash
python3 /path/to/github-publish-zip/scripts/pack_github_publish_zip.py /path/to/project --backend-priority 7z,zip,python
```

## Boundary Rules

Do not use `git archive` for this workflow; it does not include untracked publishable files or unstaged working tree content. Do not manually glob the filesystem because that bypasses Git ignore rules.

Do not silently hide backend fallback. The script must report the selected backend and any unavailable higher-priority backends in normal or JSON output.

If the minute-based archive already exists, the script stops by default. Use `--force` only when the user accepts overwriting that local archive.

## Verification

After creating an archive, report the archive path, included file count, and selected backend from the script output. Inspect archive contents before calling it done, using whichever tool is available:

```bash
unzip -l /path/to/project/local/project-YYYYMMDD-hhmm.zip
# or
7z l /path/to/project/local/project-YYYYMMDD-hhmm.zip
```

Confirm that no path starts with `.git/`. If the dry run or creation reports skipped missing tracked files, mention that the worktree has tracked paths missing on disk.
Files in this package (2)
  • SKILL.md 3 KB
  • scripts/pack_github_publish_zip.py 15 KB

Versions

The database has no other skills named github-publish-zip.

Database snapshot: 13.11.2026 · package version 11b59f0085c1 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 98devexpress-office-file-api-zip
    Build .NET applications with the DevExpress Zip Compression and Archive API for creating, reading, and extracting ZIP archives programmatically. Use when creating zip files, extracting archives, compressing files or streams, adding password protection to archives, compressing…
  • 86gh-org-backup
    Back up every GitHub repo the user can read in one organization (or their whole account) into a single zip, with every branch checked out locally. Use when the user wants to download, back up, archive, export, mirror or zip all repos of a GitHub org or account.
  • 100repo-audit
    Conduct a full audit of an uploaded code repository (provided as a zip archive) and produce a structured Markdown report of findings — ready to feed into Claude Code to create GitHub issues. Use this skill whenever the user uploads or references a zip file of a repository and…
  • 100wp-plugin-zip
    Builds and checks WordPress plugin and theme .zip packages so they install and activate cleanly. Use it whenever you package a WordPress plugin or theme for upload, a release or a client, and whenever the user reports "Plugin file does not exist", "The package could not be…
  • 100tizen-tv-sdk-install-from-zip
    Install TV SDK from ZIP, TV SDK ZIP install, TV SDK ZIP 설치, TV SDK ZIP으로 설치, 타이젠 TV SDK ZIP 설치, Samsung TV SDK offline install, TV extension install from ZIP, offline TV SDK, local ZIP TV SDK. Use this skill to install the Tizen TV SDK extension (TV-SAMSUNG-Public) from a local…
  • 81phpbb-extension-releases
    Prepare, package, publish, and verify phpBB extension releases or explicitly requested rolling development refreshes using the shared release tools. Does not authorize a release from a merge alone. Use when asked to tag, package, publish, or refresh a dev release of an…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.