Package Skill for DistributionValidate and package a Claude Code Skill into a distributable zip file## InstructionsThis command validates and packages an existing skill for distribution. Follow these steps:### Phase 1: Skill Selection1. Identify the skill to package - Determine skill location (personal or project) - Verify skill exists and has SKILL.md - Check current state of the skill2. Pre-package checks - Ensure all TODOs are completed - Verify documentation is finalized - Check that examples are tested### Phase 2: Validation1. Run quick validation - Use the quick_validate.py script - Check YAML frontmatter validity - Verify required fields (name, description) - Check for prohibited characters - Validate directory structure2. Run comprehensive validation (if quick validation passes) - Use validate-skill.sh for detailed checks - Verify all 10 validation phases - Check word counts for progressive disclosure - Validate file references - Test script syntax3. Review validation results - Fix any critical errors - Address warnings if needed - Re-validate after fixes### Phase 3: Packaging1. Execute packaging script bash python .claude/commands/skills/scripts/package_skill.py <skill-path> [output-dir] 2. Package creation process - Script validates again before packaging - Creates zip file with skill name - Includes all files while maintaining structure - Excludes hidden files and __pycache__3. Verify package - Check zip file created successfully - Note file count and size - Confirm ready for distribution### Phase 4: Distribution Options1. Personal distribution - Share zip file directly - Upload to file sharing service - Include installation instructions2. Team distribution - Add to shared repository - Upload to team storage - Document in team wiki3. Public distribution - Upload to skill marketplace (if available) - Share on GitHub - Add to community repositories## Command Execution Flow### Step 1: Locate Skillbash# Personal skillsls ~/.claude/skills/# Project skillsls .claude/skills/### Step 2: Quick Validationbashpython .claude/commands/skills/scripts/quick_validate.py <skill-path>Expected output:- Ô£à Skill validation passed!- Or specific error messages to fix### Step 3: Comprehensive Validation (Optional)bash.claude/commands/skills/scripts/validate-skill.sh <skill-path>Expected output:- Detailed 10-phase validation report- Score and recommendations### Step 4: Package Creationbash# Package to current directorypython .claude/commands/skills/scripts/package_skill.py ~/.claude/skills/my-skill# Package to specific directorypython .claude/commands/skills/scripts/package_skill.py ~/.claude/skills/my-skill ./distExpected output:­ƒöì Validating skill...Ô£à Skill validation passed!­ƒôª Creating package... Added: my-skill/SKILL.md Added: my-skill/scripts/helper.py Added: my-skill/references/api-docs.md ...Ô£à Successfully packaged skill! ­ƒôª Package: ./my-skill.zip ­ƒôè Files: 8 ­ƒÆ¥ Size: 0.15 MB­ƒôñ Ready for distribution!## Validation CriteriaThe packaging script checks:### Required Elements- SKILL.md exists- Valid YAML frontmatter- Name and description fields present- No TODO markers in description### Quality Checks- Description in third-person format- Description mentions when to use skill- No angle brackets in description- Word count within limits (<5,000 for SKILL.md)### Structure Validation- Proper directory organization- Scripts are executable- File references are valid- No duplicate content between SKILL.md and references/## Distribution Guidelines### Installation Instructions TemplateInclude with your packaged skill:markdown# Installing {{SKILL_NAME}}## Personal Installation1. Download {{skill-name}}.zip2. Extract to ~/.claude/skills/3. Restart Claude Code## Project Installation1. Extract to .claude/skills/ in your project2. Commit to version control3. Team members get skill on pull## VerificationAfter installation, test with:"Use the {{SKILL_NAME}} skill to {{example task}}"### Version ManagementFor skill updates:1. Update skill files2. Document changes in SKILL.md3. Increment version if using versioning4. Re-package with same process5. Distribute new package## Troubleshooting### Validation FailsIssue: Package script reports validation errorsSolution:1. Run quick_validate.py to see specific errors2. Fix reported issues3. Re-run validation4. Try packaging again### Package Not CreatedIssue: Zip file not generatedPossible causes:- Validation failed (fix errors first)- No write permissions (check directory)- Disk space issues (check available space)### Scripts Not ExecutableIssue: Warning about non-executable scriptsSolution:bashchmod +x <skill-path>/scripts/*.pychmod +x <skill-path>/scripts/*.sh### Large Package SizeIssue: Package is very largeSolutions:- Move large docs to references/ directory- Remove unnecessary files- Compress images if included- Use .gitignore patterns## Best Practices1. Complete all TODOs before packaging2. Test the skill thoroughly before distribution3. Document dependencies clearly4. Include examples that work5. Version your skills for updates6. Test installation on clean system7. Include uninstall instructions if complex## Examples### Example 1: Package Simple Skillbash# Validate firstpython .claude/commands/skills/scripts/quick_validate.py ~/.claude/skills/commit-helper# Package if validpython .claude/commands/skills/scripts/package_skill.py ~/.claude/skills/commit-helper# Result: commit-helper.zip created### Example 2: Package to Distribution Directorybash# Create dist directorymkdir -p ~/skill-packages# Package to specific locationpython .claude/commands/skills/scripts/package_skill.py \ ~/.claude/skills/pdf-processor \ ~/skill-packages# Result: ~/skill-packages/pdf-processor.zip### Example 3: Fix and Re-packagebash# Initial validation failspython .claude/commands/skills/scripts/quick_validate.py ~/.claude/skills/my-skill# ﯔ Description contains TODO markers# Fix the issue# Edit SKILL.md to complete TODOs# Re-validatepython .claude/commands/skills/scripts/quick_validate.py ~/.claude/skills/my-skill#  Skill validation passed!# Packagepython .claude/commands/skills/scripts/package_skill.py ~/.claude/skills/my-skill#  Successfully packaged!## Output FormatThe command provides clear feedback:­ƒôª Packaging skill: {{skill-name}}­ƒöì Validating skill...[Validation results]­ƒôª Creating package...[File listing]Ô£à Successfully packaged skill! ­ƒôª Package: {{path/to/package.zip}} ­ƒôè Files: {{count}} ­ƒÆ¥ Size: {{size}} MB­ƒôñ Ready for distribution!## Next StepsAfter packaging:1. Test installation on another system2. Share with team or community3. Document in skill catalog4. Gather feedback for improvements5. Plan updates based on usage## Related Commands- /skills:build-skill - Create new skills- /skills:init-skill - Initialize skill from template- /skills:validate-skill - Run validation only## Scripts Used- package_skill.py - Main packaging script- quick_validate.py - Fast validation- validate-skill.sh - Comprehensive validationYour skill is now ready for distribution! ­ƒôª