Where should the plugin manifest be located?

The manifest must be named plugin.json and must be placed inside the .claude-plugin/ directory at the root of your plugin.

What is the difference between a Skill and a Command?

Commands are manually invoked by the user via slash commands, whereas Skills are autonomously activated by Claude when the task context matches the skill's description.

How does Claude Code discover new commands?

Claude Code uses an auto-discovery mechanism that automatically scans and loads all .md files located in the commands/ directory at the plugin root.

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is a portable environment variable used for intra-plugin path references, ensuring your scripts and hooks work regardless of the user's OS or installation path.

Can I use custom paths for my plugin components?

Yes, you can specify custom paths in your plugin.json manifest, which will supplement the default auto-discovery directories.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

開発者ツール

Guides the creation and organization of Claude Code plugins through standardized directory layouts and manifest configurations.

概要

This skill provides comprehensive guidance for developers looking to build, scaffold, or optimize the architecture of Claude Code plugins. It covers essential architectural requirements, including the mandatory .claude-plugin/plugin.json manifest, automatic component discovery for commands and agents, and the implementation of portable paths using the ${CLAUDE_PLUGIN_ROOT} variable. By following these patterns, developers can create maintainable, cross-platform plugins that integrate seamlessly with Claude Code's native capabilities.

主な機能

Portable path management using ${CLAUDE_PLUGIN_ROOT} references
Component-based organization for commands, agents, skills, and hooks
Best practices for file naming and cross-platform plugin portability
Standardized directory layout for automatic component discovery
1 GitHub stars
Manifest configuration guidance for .claude-plugin/plugin.json

ユースケース

Refactoring existing scripts into a valid Claude Code plugin structure for distribution
Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy
Troubleshooting component discovery and path resolution issues within custom plugins

概要

主な機能

Portable path management using ${CLAUDE_PLUGIN_ROOT} references
Component-based organization for commands, agents, skills, and hooks
Best practices for file naming and cross-platform plugin portability
Standardized directory layout for automatic component discovery
1 GitHub stars
Manifest configuration guidance for .claude-plugin/plugin.json

ユースケース

Refactoring existing scripts into a valid Claude Code plugin structure for distribution
Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy
Troubleshooting component discovery and path resolution issues within custom plugins