How do I ensure my plugin works on different operating systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal file references rather than hardcoding absolute paths or relative shortcuts.

Where should the Claude Code plugin manifest be located?

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

What is the difference between Commands and Agents in a plugin?

Commands are user-invoked slash commands defined in Markdown, while Agents are specialized sub-entities that Claude Code can invoke automatically based on the task context.

Does Claude Code automatically detect my plugin components?

Yes, Claude Code uses an auto-discovery mechanism that scans specific directories like /commands, /agents, and /skills for compatible Markdown files.

Claude Code Plugin Structure

Name: Claude Code Plugin Structure
Author: lusya123

bylusya123

0•

Developer Tools

Standardizes the architecture and directory layout for Claude Code plugins to ensure portability and automatic component discovery.

This skill provides comprehensive guidance on organizing Claude Code plugins, from manifest configuration in .claude-plugin/plugin.json to implementing commands, agents, and hooks. It ensures developers follow best practices for component-based organization and portable path references using ${CLAUDE_PLUGIN_ROOT}, enabling seamless integration and distribution across different operating systems and installation methods. By following these patterns, developers can leverage Claude Code's auto-discovery mechanism to build maintainable and scalable AI extensions.

Key Features

01Standardized directory layout mapping for commands, agents, skills, and hooks

020 GitHub stars

03Automated component discovery configuration and manifest management

04Best practices for modular plugin design and cross-platform compatibility

05Portable path resolution using the ${CLAUDE_PLUGIN_ROOT} environment variable

06Naming convention enforcement for kebab-case files and directories

Use Cases

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

02Refactoring an existing plugin to support portability and auto-discovery

03Troubleshooting component loading issues in complex plugin architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lusya123/cloudcode plugin-structure

For use in Claude.ai and ChatGPT

Download Skill