How do I test my Han plugin locally?

You can install a local plugin by running 'han plugin install /path/to/plugin --scope project' or by manually adding it to your .claude/settings.json file.

What can lifecycle hooks do in a plugin?

Hooks allow you to run validation scripts or automation during events like SessionStart, PreToolUse, and Stop, ensuring code quality and safety during the development process.

Which files are required for a Han plugin?

A valid plugin must include a .claude-plugin/plugin.json file for metadata and a README.md for documentation. Skills and hooks are optional based on the plugin's purpose.

What are the different types of Han plugins?

Han supports three types: Jutsu for language/tool skills, Do for specialized domain agents, and Hashi for MCP bridge servers connecting to external integrations.

Han Plugin Development

Name: Han Plugin Development
Author: TheBushidoCollective

byTheBushidoCollective

•

Developer Tools

Facilitates the creation, configuration, and validation of Han plugins to extend Claude Code capabilities.

The Han Plugin Development skill provides comprehensive guidance for developers building specialized extensions for the Han marketplace. It offers expert knowledge on the three core plugin types—Jutsu, Do, and Hashi—ensuring that every extension follows strict directory structures and ethical software development principles. From configuring lifecycle hooks in YAML to defining sophisticated skill documentation in Markdown, this tool ensures plugins are robust, valid, and ready for deployment within the Claude Code environment.

Key Features

0174 GitHub stars

02Detailed implementation patterns for lifecycle hooks and event triggers

03Standardized templates for SKILL.md and custom slash commands

04Best practice enforcement for shell scripts and environment variables

05Comprehensive validation for plugin.json and han-plugin.yml files

06Structural guidance for Jutsu, Do, and Hashi plugin types

Use Cases

01Bootstrapping a new plugin with the required directory structure and metadata

02Defining automated validation hooks that trigger during tool execution or session stops

03Troubleshooting plugin installation errors and configuration syntax issues

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han plugin-development

For use in Claude.ai and ChatGPT

Download Skill