What is the mandatory location for the plugin manifest?

The plugin.json file must always be located within the .claude-plugin/ directory at the root of your plugin folder.

How does Claude Code discover new commands or agents?

Claude Code automatically scans the commands/ and agents/ directories for .md files. If they contain valid YAML frontmatter, they are registered automatically.

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

Using ${CLAUDE_PLUGIN_ROOT} ensures your plugin is portable. It allows the plugin to function correctly regardless of the operating system or specific installation path used by the user.

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 within the plugin.json manifest.

Claude Code Plugin Structuring

Name: Claude Code Plugin Structuring
Author: astrosteveo

byastrosteveo

•

Developer Tools

Standardizes and scaffolds the directory architecture for Claude Code plugins to ensure seamless component discovery.

This skill provides a comprehensive framework for organizing Claude Code plugins using a standardized directory layout. It guides developers through setting up the .claude-plugin/plugin.json manifest, managing commands, agents, and skills, and implementing portable path references using ${CLAUDE_PLUGIN_ROOT}. By following these architectural best practices, developers can create maintainable, auto-discoverable, and portable plugins that integrate natively with Claude Code’s tool system and component model.

Key Features

01Implementation of portable pathing using ${CLAUDE_PLUGIN_ROOT}

02Manifest configuration guidance for .claude-plugin/plugin.json

03Auto-discovery configuration for hooks and MCP server definitions

041 GitHub stars

05Automated directory scaffolding for commands, agents, and skills

06Standardized naming conventions and kebab-case file organization

Use Cases

01Configuring complex plugins with multiple agents and custom MCP server paths

02Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy

03Refactoring existing scripts into standardized Claude Code component models

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/marketplace plugin-structure

For use in Claude.ai and ChatGPT

Key Features

01Implementation of portable pathing using ${CLAUDE_PLUGIN_ROOT}

02Manifest configuration guidance for .claude-plugin/plugin.json

03Auto-discovery configuration for hooks and MCP server definitions

041 GitHub stars

05Automated directory scaffolding for commands, agents, and skills

06Standardized naming conventions and kebab-case file organization

Use Cases

01Configuring complex plugins with multiple agents and custom MCP server paths

02Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy

03Refactoring existing scripts into standardized Claude Code component models

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/marketplace plugin-structure

For use in Claude.ai and ChatGPT