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

•

Herramientas para Desarrolladores

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

Acerca de

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.

Características Principales

Implementation of portable pathing using ${CLAUDE_PLUGIN_ROOT}
Manifest configuration guidance for .claude-plugin/plugin.json
Auto-discovery configuration for hooks and MCP server definitions
1 GitHub stars
Automated directory scaffolding for commands, agents, and skills
Standardized naming conventions and kebab-case file organization

Casos de Uso

Configuring complex plugins with multiple agents and custom MCP server paths
Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy
Refactoring 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

Download Skill

GitHub