package-skill — Claude Code command: package a skill
package-skill is a Claude Code command that checks a skill and builds a ZIP for sharing, team distribution, or publication.
no license ★ 1,357 updated 2026-03-01
.claude/commands/package-skill.mdWhat package-skill 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/.
What it helps with
- 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 for the agent
- Run
/package-skillon the skill at~/.claude/skills/commit-helperand create its distribution archive. - Check
.claude/skills/my-skill, fix validation issues, and package the result into./dist. - Validate
SKILL.mdand build a ZIP for thepdf-processorskill.
How to install package-skill
Manually: put the files in place
.claude/commands/package-skill.mdCall it with /package-skill. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/package-skill.mdCall it with /prompts:package-skill. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/package-skill.prompt.mdManually: put the files in place
.gemini/commands/package-skill.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about package-skill
How do I install package-skill in Claude Code?
Place the command file at .claude/commands/package-skill.md.
What does package-skill do?
It validates an existing Claude Code skill, checks its structure, and bundles the skill files into a ZIP archive for distribution.
What does a skill need before packaging?
It needs an SKILL.md file with valid YAML frontmatter and name and description fields. Deeper checks use validate-skill.sh and the scripts in .claude/commands/skills/scripts/.