# package-skill

package-skill is a Claude Code command that checks a skill and builds a ZIP for sharing, team distribution, or publication.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/skills/package-skill.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/package-skill

## What it does

The command locates a skill under `~/.claude/skills/` or `.claude/skills/`, confirms that `SKILL.md` exists, and checks whether the skill is ready to package. Its quick pass examines YAML frontmatter, required fields, prohibited characters, and directory layout.

When that pass succeeds, the command can run `validate-skill.sh` for deeper checks. This covers file references, script syntax, structure, and documentation limits. The packaging step calls `package_skill.py`, validates again, and creates a ZIP while preserving the skill’s directory structure and leaving out hidden files and `__pycache__`.

The package cannot pass validation without `SKILL.md`. The workflow also relies on `quick_validate.py` and `package_skill.py` in `.claude/commands/skills/scripts/`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/package-skill.md` — Call it with /package-skill. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/package-skill.md` — Call it with /prompts:package-skill. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/package-skill.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/package-skill.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/skills/package-skill.md

## When to use it
- validate a skill before publishing it
- check YAML frontmatter and required fields
- catch broken file references and script syntax
- create a distributable ZIP archive
- prepare a skill for team sharing

## Example prompts
- Run `/package-skill` on the skill at `~/.claude/skills/commit-helper` and create its distribution archive.
- Check `.claude/skills/my-skill`, fix validation issues, and package the result into `./dist`.
- Validate `SKILL.md` and build a ZIP for the `pdf-processor` skill.

## Similar
- [mpc-plugin-package](https://affpapa.org/en/nevibecode/skills/mpc-plugin-package.md) — skill · ★ 200 repo stars
- [python-pypi-package-builder](https://affpapa.org/en/nevibecode/skills/python-pypi-package-builder.md) — skill · 943 installs
- [atb-game-package](https://affpapa.org/en/nevibecode/skills/atb-game-package.md) — skill · ★ 369 repo stars
- [nuget-package-publishing](https://affpapa.org/en/nevibecode/rules/nuget-package-publishing.md) — rule · ★ 138 repo stars
- [skill-creator](https://affpapa.org/en/nevibecode/skills/dkyazzentwatwa-skill-creator.md) — skill · 167 installs
- [suede-launch-packaging](https://affpapa.org/en/nevibecode/skills/suede-launch-packaging.md) — skill · ★ 121 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
