Can I use custom paths for plugin components?

Yes, you can specify custom paths in the plugin.json manifest, which will supplement the default auto-discovery locations.

What is the required location for the plugin manifest?

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

Why should I use ${CLAUDE_PLUGIN_ROOT}?

Using this environment variable ensures your plugin paths remain portable across different operating systems, user home directories, and installation methods.

How does Claude Code discover plugin components?

It automatically scans specific root-level directories like commands/, agents/, skills/, and hooks/ for relevant configuration and markdown files.

Claude Code Plugin Structure

Name: Claude Code Plugin Structure
Author: jawhnycooke

byjawhnycooke

0•

Developer Tools

Guides developers through the standardized directory layout and manifest configuration for building Claude Code plugins.

This skill provides comprehensive guidance on organizing Claude Code plugins, ensuring seamless integration through automatic component discovery. It covers the essential .claude-plugin/plugin.json manifest, the standardized directory structure for commands, agents, and hooks, and the use of the ${CLAUDE_PLUGIN_ROOT} variable for portable pathing. Whether you are scaffolding a new project or optimizing an existing one, this skill helps you implement architecture best practices and component-based organization for maintainable, high-quality plugins.

Key Features

01Component-based organization for agents and skills

020 GitHub stars

03Automatic component discovery setup

04Manifest configuration guidance for plugin.json

05Portable pathing with ${CLAUDE_PLUGIN_ROOT}

06Standardized directory layout conventions

Use Cases

01Scaffolding a new Claude Code plugin from scratch

02Migrating existing developer utilities to the official plugin format

03Implementing portable file paths for cross-platform plugin support

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jawhnycooke/claude-plugins plugin-structure

For use in Claude.ai and ChatGPT

Download Skill