What is the required location for the plugin manifest?

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

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

You should always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal path references to ensure portability across macOS, Linux, and Windows.

Does Claude Code automatically find my commands?

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

Can I use custom directory names for my plugin components?

Yes, while default directories are scanned automatically, you can specify custom paths in the plugin.json manifest using relative paths starting with ./

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

Developer Tools

Guides developers in scaffolding, organizing, and configuring Claude Code plugins using standardized directory structures and manifest patterns.

This skill provides comprehensive architectural guidance for building Claude Code plugins, ensuring seamless integration through proper directory layouts and manifest configurations. It helps users navigate the complexities of component-based organization—including commands, agents, skills, and hooks—while enforcing best practices like portable path references via ${CLAUDE_PLUGIN_ROOT}. By following this standardized approach, developers can create maintainable, auto-discoverable extensions that enhance Claude's capabilities across different operating systems and installation environments.

Key Features

01Manifest (plugin.json) configuration guidance

02Portable path referencing with ${CLAUDE_PLUGIN_ROOT}

0381 GitHub stars

04Standardized directory layout scaffolding

05Component organization for commands and agents

06Automatic component discovery patterns

Use Cases

01Migrating custom scripts into a structured plugin format

02Scaffolding a new Claude Code plugin from scratch

03Optimizing plugin manifests for automatic component discovery

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