What is the required location for the plugin manifest?

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

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

Using the ${CLAUDE_PLUGIN_ROOT} variable ensures your plugin remains portable across different operating systems and installation methods where the absolute path might vary.

Can I use custom directory names for my plugin components?

Yes, while default directories are auto-discovered, you can specify custom paths within the 'commands', 'agents', or 'skills' fields in your plugin.json manifest to supplement the defaults.

What naming convention is recommended for plugin files?

It is best practice to use kebab-case (lowercase with hyphens) for all directory and file names to ensure consistency and avoid cross-platform naming conflicts.

How does Claude Code discover new commands or agents?

Claude Code uses an auto-discovery mechanism that scans specific directories, such as /commands or /agents, for markdown files containing YAML frontmatter.

Plugin Architecture Guide

Name: Plugin Architecture Guide
Author: anthropics

byanthropics

•

291

•

开发者工具

Standardizes Claude Code plugin development with guidance on directory layouts, manifest configuration, and automated component discovery.

The Plugin Structure skill provides essential architectural patterns and implementation details for building robust Claude Code plugins. It simplifies the development process by guiding users through the creation of the required .claude-plugin directory, the configuration of plugin.json manifests, and the organization of modular components like commands, agents, and hooks. By enforcing best practices such as portable path references using the ${CLAUDE_PLUGIN_ROOT} variable and leveraging the auto-discovery mechanism, this skill ensures that plugins are maintainable, portable across different operating systems, and seamlessly integrated into the Claude Code ecosystem.

主要功能

01Standards for file naming and modular component organization

02Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}

03Automated directory scaffolding for commands, agents, and skills

04Optimization of component auto-discovery for seamless loading

05291 GitHub stars

06Manifest configuration guidance for plugin.json metadata

使用场景

01Migrating hardcoded paths to portable environment variables for cross-platform support

02Organizing complex plugins with multiple subagents, slash commands, and MCP servers

03Scaffolding a new Claude Code plugin from scratch with the correct directory tree

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add anthropics/claude-plugins-official plugin-structure

For use in Claude.ai and ChatGPT

Download Skill