skill-packager

Package Claude Code skills into versioned ZIP archives with generated documentation.

Updated Jul 26, 2026
One-click install
npx skills add https://github.com/shawn-sandy/skills --skill skill-packager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-packager
Source: https://github.com/shawn-sandy/skills/tree/main/skill-packager
Command: npx skills add https://github.com/shawn-sandy/skills --skill skill-packager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Manually packaging, documenting, and versioning custom AI skills for distribution is tedious and error-prone. This skill automates the entire process, ensuring your skills are consistently packaged, professionally documented, and correctly versioned for sharing or archival.

Core Features & Use Cases

  • Automated Packaging: Creates versioned ZIP files, excluding unnecessary files.
  • Documentation Generation: Automatically generates installation and user guides from templates.
  • Semantic Versioning: Guides you through MAJOR, MINOR, or PATCH increments, updating SKILL.md.
  • Use Case: You've developed a new skill and want to share it with your team. Use this skill to generate a ready-to-distribute ZIP, complete with a Download.md and User Guide.md, ensuring everyone can install and use it correctly.

Quick Start

Package the my-new-skill located at ~/.claude/skills/my-new-skill as a minor version increment.

Frequently Asked Questions about skill-packager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate packaging and versioning skills for distribution?

Packaging skills involves creating versioned ZIP archives with documentation. This skill automates the entire process—validating your SKILL.md file, extracting version numbers, generating installation guides, and producing distribution-ready outputs with standardized layouts, eliminating manual steps and ensuring consistency.

What does semantic versioning mean for skill releases?

Semantic versioning uses three numbers (MAJOR.MINOR.PATCH) to signal compatibility. This skill guides you through version increments—MAJOR for breaking changes, MINOR for new features, PATCH for fixes—and automatically updates your SKILL.md frontmatter to reflect the new version in your packaged archive.

Can I generate installation and user documentation automatically?

Yes. This skill uses templates to generate both Download.md (installation instructions) and User Guide.md from your skill's metadata and frontmatter. Templates automatically extract key information, ensuring consistent, professional documentation without manual writing.

What files and directories are included in the packaged skill ZIP?

Packaged skills use a standardized directory layout that includes your skill's components (scripts, references, assets), generated documentation files, and a validated SKILL.md with frontmatter. Unnecessary files are excluded to keep distributions clean and focused.

What validation happens to my skill before packaging?

Before packaging, the skill validates your SKILL.md file and enforces frontmatter requirements—checking that required metadata fields are present and correctly formatted. This prevents distribution of incomplete or malformed skills and catches errors early.

Can I package skills for team sharing or archival?

Yes. This skill is designed for distribution workflows—generating versioned, self-contained ZIP packages with embedded documentation. Package once, share with your team or archive for later retrieval; recipients have everything needed to install and understand the skill.