What is the mandatory location for the plugin manifest?

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

Why should I use ${CLAUDE_PLUGIN_ROOT} instead of relative paths?

It ensures your plugin remains portable across different operating systems and installation methods (like npm or local) by providing a dynamic reference to the absolute root path.

How does Claude Code discover new commands or skills?

Claude Code uses an auto-discovery mechanism that scans specific directories like commands/, agents/, and skills/ for markdown and JSON configuration files.

Can I use custom directories for my plugin components?

Yes, you can specify custom paths in the plugin.json manifest; these paths will supplement rather than replace the default auto-discovery directories.

Claude Code Plugin Architecture

Name: Claude Code Plugin Architecture
Author: Claude-Code-Community-Ireland

byClaude-Code-Community-Ireland

•

开发者工具

Standardizes Claude Code plugin development with predefined directory layouts, manifest configurations, and component discovery patterns.

This skill provides a comprehensive blueprint for building robust Claude Code plugins, ensuring seamless integration through standardized directory structures and manifest-driven configurations. It guides developers through the organization of commands, agents, and skills while implementing best practices like portable path references via environment variables. By following these architectural patterns, developers can create maintainable, auto-discoverable extensions that enhance Claude's capabilities across any operating system or environment.

主要功能

01Portable path referencing using ${CLAUDE_PLUGIN_ROOT}

02Event-driven hook system implementation (PreToolUse, SessionStart, etc.)

036 GitHub stars

04Automated component discovery for commands, agents, and skills

05Standardized manifest configuration via plugin.json

06Structured MCP server integration and configuration

使用场景

01Scaffolding a new Claude Code plugin from scratch

02Migrating existing scripts into a formal plugin structure

03Optimizing plugin portability across different operating systems

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claude-code-community-ireland/claude-code-resources plugin-structure

For use in Claude.ai and ChatGPT

Download Skill