Where should the Claude Code plugin manifest be located?

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

Can I define custom paths for my plugin components?

Yes, you can supplement the default directories by specifying custom relative paths for commands, agents, or hooks within your plugin.json manifest.

How does Claude Code discover my plugin components?

Claude Code uses an auto-discovery mechanism that scans default directories at the plugin root, such as /commands, /agents, and /skills.

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is an environment variable used to reference the plugin's root directory, ensuring that paths remain portable across different user environments and operating systems.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

114

•

Developer Tools

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

This skill provides comprehensive guidance on the Claude Code plugin architecture, covering everything from initial scaffolding to advanced configuration. It ensures developers follow best practices for component organization—including commands, agents, skills, and hooks—while leveraging the manifest-driven discovery system. By utilizing the ${CLAUDE_PLUGIN_ROOT} environment variable and standardized naming conventions, this skill helps users build portable, maintainable, and production-ready extensions that integrate perfectly with the Claude Code ecosystem.

Key Features

01Standardized directory layout and scaffolding guidance

02Detailed manifest (plugin.json) configuration support

03Automated component discovery and registration rules

04Portable path resolution using ${CLAUDE_PLUGIN_ROOT}

05Best practices for commands, agents, skills, and hooks

06114 GitHub stars

Use Cases

01Troubleshooting component loading and auto-discovery issues

02Scaffolding a new Claude Code plugin with correct directory hierarchy

03Refactoring hardcoded paths to ensure cross-platform portability

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