How does Claude Code find my plugin commands?

Claude Code uses an auto-discovery mechanism that automatically scans the commands/ directory for Markdown files with YAML frontmatter.

Why should I use ${CLAUDE_PLUGIN_ROOT} in my paths?

It ensures your plugin remains portable across different operating systems and installation methods by resolving to the absolute path of the plugin at runtime.

Can I use custom directory names for my plugin components?

Yes, while there are default directories, you can specify custom paths for commands, agents, and hooks in the plugin.json manifest to supplement the defaults.

What is the required location for the plugin manifest?

The plugin.json manifest must always be located within the .claude-plugin/ directory at the plugin root level.

Claude Code Plugin Structure & Architect

Name: Claude Code Plugin Structure & Architect
Author: nsalvacao

bynsalvacao

0•

开发者工具

Standardizes Claude Code plugin development by providing scaffolding, directory layouts, and architectural best practices.

This skill streamlines the creation and organization of Claude Code plugins by enforcing a standardized directory structure and manifest configuration. It guides developers through setting up commands, agents, skills, and hooks while ensuring portability using the ${CLAUDE_PLUGIN_ROOT} variable. Whether you are scaffolding a new project or optimizing an existing one, this skill ensures your plugins integrate seamlessly with Claude Code's auto-discovery mechanism and follow production-grade naming and layout conventions.

主要功能

01Automated plugin directory scaffolding and component organization

02Manifest (plugin.json) configuration and metadata management

03Standardized naming conventions and component lifecycle management

04Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}

050 GitHub stars

06Guidance on auto-discovery for commands, agents, and skills

使用场景

01Configuring hooks and MCP servers for deep integration with Claude Code

02Scaffolding a new Claude Code plugin with a valid, production-ready folder structure

03Organizing existing scripts and prompts into a discoverable plugin format

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins plugin-structure

For use in Claude.ai and ChatGPT

主要功能

01Automated plugin directory scaffolding and component organization

02Manifest (plugin.json) configuration and metadata management

03Standardized naming conventions and component lifecycle management

04Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}

050 GitHub stars

06Guidance on auto-discovery for commands, agents, and skills

使用场景

01Configuring hooks and MCP servers for deep integration with Claude Code

02Scaffolding a new Claude Code plugin with a valid, production-ready folder structure

03Organizing existing scripts and prompts into a discoverable plugin format

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins plugin-structure

For use in Claude.ai and ChatGPT