How does auto-discovery work in Claude Code?

Claude Code automatically scans specific directories like commands/, agents/, and skills/ for component files, registering them automatically without requiring manual manifest entries.

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is an environment variable used for portable path references, ensuring your plugin works across different operating systems and installation paths without hardcoded strings.

Can I use custom paths for plugin components?

Yes, you can specify custom paths in the plugin.json file. These paths will supplement the default auto-discovery directories rather than replacing them.

Where should the plugin manifest be located?

The plugin.json manifest must be placed within the .claude-plugin/ directory at the plugin root to be correctly recognized.

Plugin Structure & Scaffolding

Name: Plugin Structure & Scaffolding
Author: Microck

byMicrock

•

108

開発者ツール

Standardizes and scaffolds Claude Code plugin development through structured directory layouts and manifest configurations.

概要

This skill provides comprehensive guidance on architecting Claude Code plugins, ensuring seamless integration through standardized directory structures and manifest-driven configurations. It assists developers in organizing commands, agents, skills, and hooks while implementing best practices for portability using the ${CLAUDE_PLUGIN_ROOT} variable. Whether you are scaffolding a new plugin from scratch or refactoring an existing project, this skill ensures your work follows auto-discovery conventions for a maintainable and portable codebase.

主な機能

Automated plugin directory scaffolding and organization
Auto-discovery setup for commands, agents, and skills
Portable path management using ${CLAUDE_PLUGIN_ROOT}
Standardized .claude-plugin/plugin.json manifest configuration
108 GitHub stars
Best practice guidance for naming conventions and component lifecycle

ユースケース

Creating a new Claude Code plugin with a standard file structure
Refactoring a disorganized plugin to ensure components are auto-discovered
Configuring hooks and MCP servers within a portable plugin environment

概要

主な機能

Automated plugin directory scaffolding and organization
Auto-discovery setup for commands, agents, and skills
Portable path management using ${CLAUDE_PLUGIN_ROOT}
Standardized .claude-plugin/plugin.json manifest configuration
108 GitHub stars
Best practice guidance for naming conventions and component lifecycle

ユースケース

Creating a new Claude Code plugin with a standard file structure
Refactoring a disorganized plugin to ensure components are auto-discovered
Configuring hooks and MCP servers within a portable plugin environment