How do I ensure my plugin paths work on all systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all intra-plugin references to ensure portability across different operating systems and user installation paths.

What is the required location for the plugin manifest?

The plugin.json manifest must always be located within the .claude-plugin/ directory at the plugin's root level.

What components are auto-discovered by Claude Code?

Claude Code automatically scans and loads markdown files in the commands/ and agents/ directories, as well as SKILL.md files located within subdirectories of the skills/ folder.

Can I use custom directories for my plugin components?

Yes, you can specify custom paths in the plugin.json manifest using the commands, agents, or skills fields. Note that these supplement the default directories rather than replacing them.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

143

•

开发者工具

Guides developers in scaffolding, organizing, and configuring standardized Claude Code plugins and manifests.

This skill serves as a comprehensive architectural guide for building Claude Code plugins, ensuring developers follow standardized directory layouts and implementation best practices. It assists in creating the mandatory manifest files, managing component discovery for commands and agents, and correctly utilizing environment variables like ${CLAUDE_PLUGIN_ROOT} for portable pathing. Whether you are setting up new event hooks, integrating MCP servers, or organizing complex skill subdirectories, this tool provides the necessary patterns to ensure seamless integration and long-term maintainability within the Claude Code ecosystem.

主要功能

01Portable path management using the ${CLAUDE_PLUGIN_ROOT} variable

02Standardized plugin directory scaffolding and layout guidance

03Manifest (plugin.json) configuration and metadata optimization

04Event hook registration and MCP server configuration patterns

05143 GitHub stars

06Component auto-discovery for commands, agents, and skills

使用场景

01Debugging manifest issues or path resolution errors in complex plugin architectures

02Converting existing standalone scripts into organized Claude commands and skills

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 microck/ordinary-claude-skills command-name

For use in Claude.ai and ChatGPT

Download Skill