plugin-packager

Package claudefiles components into a valid Claude Code plugin

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 28, 2025

When & Why to Use This Skill

The Plugin Packager skill streamlines the development of Claude Code extensions by bundling various components—including agents, commands, hooks, and skills—into a standardized, valid plugin format. It automates the creation of the essential plugin.json configuration and ensures that all directory structures and file permissions meet the requirements for seamless local installation and deployment.

Use Cases

  • Standardizing Plugin Development: Automatically organize multi-language components (Go, TypeScript, Python) into a structured format that Claude Code can recognize and execute.
  • Automated Metadata Configuration: Generate and validate the plugin.json file to ensure mandatory fields like name, version, and component paths are correctly defined.
  • Local Testing and Validation: Simplify the process of installing custom extensions locally using the --scope local flag, allowing for rapid iteration and debugging of new Claude skills.
  • Permission and Path Management: Ensure all hook scripts have the necessary executable permissions and that all internal paths follow the required relative pathing conventions to prevent runtime errors.
nameplugin-packager
descriptionPackage claudefiles components into a valid Claude Code plugin

Plugin Packager

Quick Package (Default)

Create .claude-plugin/plugin.json:

{
  "name": "claudefiles",
  "version": "1.0.0",
  "description": "Claude Code components: agents, commands, hooks, skills",
  "license": "MIT",
  "commands": ["./commands/golang/", "./commands/typescript/", "./commands/docs/"],
  "agents": ["./agents/golang/", "./agents/typescript/", "./agents/python/", "./agents/docs/", "./agents/general/"],
  "skills": "./skills/",
  "hooks": ["./hooks/golang/hooks.json", "./hooks/security/hooks.json"]
}

Validate

chmod +x hooks/golang/scripts/*.sh hooks/security/scripts/*.py
claude plugin install . --scope local

Checklist

  • .claude-plugin/ directory exists
  • plugin.json has name + version
  • Scripts have +x permission
  • All paths start with ./