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

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal path references instead of hardcoded absolute or relative paths.

What is the recommended naming convention for plugin components?

All directory and file names should use kebab-case (lowercase with hyphens) to ensure consistency and compatibility across the platform.

Does Claude Code automatically detect new commands?

Yes, Claude Code features an auto-discovery mechanism that scans the /commands, /agents, and /skills directories for compatible markdown files.

Can I define custom paths for my plugin components?

Yes, you can specify custom paths in the plugin.json manifest. These paths supplement the default directories rather than replacing them.

Where should the Claude Code plugin manifest be located?

The plugin.json manifest must be placed within a directory named .claude-plugin at the root of your plugin folder.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

138

•

开发者工具

Guides developers through the creation, organization, and scaffolding of Claude Code plugins using standardized directory structures.

This skill provides a comprehensive architectural blueprint for building Claude Code plugins, ensuring they are maintainable, portable, and fully compatible with Claude's automatic discovery mechanisms. It offers expert guidance on setting up the .claude-plugin/plugin.json manifest, organizing core components like commands, agents, and hooks, and implementing portable path references using environment variables. Whether you are scaffolding a new project or refactoring existing utilities, this skill enforces industry best practices for naming conventions and directory layouts within the Claude Code ecosystem.

主要功能

01Portable path referencing with ${CLAUDE_PLUGIN_ROOT}

02Component organization for commands, agents, and skills

03138 GitHub stars

04Manifest (plugin.json) configuration guidance

05Automatic discovery mechanism optimization

06Standardized plugin directory layout scaffolding

使用场景

01Migrating existing developer scripts into a modular plugin format

02Configuring advanced event hooks and MCP servers for seamless tool integration

03Scaffolding a new Claude Code plugin with a valid manifest and directory structure

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