Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/package-skill.md
Open on GitHub

What 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-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.

How to install package-skill

Manually: put the files in place

.claude/commands/package-skill.md

Call it with /package-skill. For all projects use ~/.claude/commands/

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/.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set112

The whole set →
ui-designer ui-designer — a Claude Code subagent for building interface mockups, design systems, and accessible layouts using magic and context7 MCP servers. CX Codex ★ 1,357repo stars cloudflare-worker Generate a Cloudflare Worker from a task description, with Wrangler configuration and sample requests. Useful for building an API, WebSocket service, or authentication middleware. CX Codex +1 ★ 1,357repo stars legacy-modernizer legacy-modernizer is a Claude Code subagent for planning and carrying out gradual changes to legacy systems. It engages on framework upgrades, codebase refactors, and monolith decomposition. CX Codex ★ 1,357repo stars todo-worktree todo-worktree takes tasks from a todo list and implements them inside isolated git worktrees with strict phased approvals. CX Codex +1 ★ 1,357repo stars parallel-tasks-help parallel-tasks-help is a Claude Code command that explains how to run /parallel-tasks, with its options, agent types, and examples. It also covers task systems and coordination stages. CX Codex +1 ★ 1,357repo stars linear-task-to-issue linear-task-to-issue exports Linear tasks into GitHub issues while preserving descriptions, child tasks, comments, and priority labels. CX Codex +1 ★ 1,357repo stars electron-pro A Claude subagent that runs an Electron project written in TypeScript: main and renderer processes, IPC through a preload bridge, packaging with electron-builder. CX Codex ★ 1,357repo stars skill-elicitation-agent skill-elicitation-agent interviews you about the skill you have in mind, then hands back a full Claude skill spec: examples, triggers, file layout and test cases. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open