Where should the plugin manifest be located?

The plugin.json manifest must be placed specifically within the .claude-plugin/ directory at the root of your plugin project.

What is the purpose of the ${CLAUDE_PLUGIN_ROOT} variable?

It is a dynamic environment variable used to reference the plugin's base directory, ensuring paths remain portable across different user environments and operating systems.

Can I define custom paths for my plugin components?

Yes, you can specify custom relative paths in the plugin.json file to supplement the default directories, allowing for flexible project organization.

How does auto-discovery work in Claude Code?

Claude Code automatically scans specific root-level directories like /commands, /agents, and /skills for markdown files to register functionality without manual configuration.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: himmelreich-it

byhimmelreich-it

0•

Developer Tools

Architects and organizes Claude Code plugins using standardized directory structures and manifest configurations for seamless AI integration.

The Plugin Structure skill provides a comprehensive blueprint for building robust Claude Code plugins. It guides developers through the essential organizational patterns required for automatic component discovery, including the setup of manifest files, slash commands, specialized agents, and event-driven hooks. By enforcing best practices like kebab-case naming and the use of the ${CLAUDE_PLUGIN_ROOT} environment variable, this skill ensures that plugins are portable, maintainable, and fully compatible with Claude Code's native architecture across different operating systems.

Key Features

01Portable path management with ${CLAUDE_PLUGIN_ROOT} variables

02Event handler registration for hooks and MCP server integration

030 GitHub stars

04Automated component discovery and registration logic

05Manifest-driven configuration using .claude-plugin/plugin.json

06Standardized directory scaffolding for commands, agents, and skills

Use Cases

01Refactoring existing scripts into a discoverable plugin for the Claude Code ecosystem

02Configuring complex event-driven hooks and background MCP servers for advanced workflows

03Scaffolding a new Claude Code plugin with a clean, standard directory layout

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add himmelreich-it/agent-skill-converter plugin-structure

For use in Claude.ai and ChatGPT

Download Skill