How does Claude Code handle component discovery?

Claude Code automatically scans the commands/, agents/, and skills/ directories for Markdown files with YAML frontmatter to register them as active components.

Can I use custom directory names for my commands?

Yes, while default directories are scanned automatically, you can specify additional custom paths for commands, agents, and hooks in the plugin.json manifest.

What is ${CLAUDE_PLUGIN_ROOT} used for?

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

Where should the plugin.json manifest be located?

The plugin.json manifest must be placed within the .claude-plugin/ directory at the root of your plugin directory to be recognized.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

0•

Developer Tools

Standardizes the creation and organization of Claude Code plugins using systematic directory structures and manifest configurations.

This skill provides comprehensive guidance on architecting Claude Code plugins, ensuring seamless integration through standardized directory layouts and manifest files. It helps developers scaffold new plugins, configure auto-discovery for commands and agents, and implement portable path references using environment variables. By following these established patterns, users can create maintainable, portable, and powerful extensions that leverage Claude's full range of capabilities, including event hooks and MCP server integrations.

Key Features

01Standardized directory scaffolding for commands, agents, and skills

02Automated component discovery and registration patterns

03Best practices for naming conventions and component organization

04Manifest configuration guidance for .claude-plugin/plugin.json

050 GitHub stars

06Portable path management using ${CLAUDE_PLUGIN_ROOT}

Use Cases

01Refactoring existing scripts into a formal, portable plugin structure

02Configuring complex event hooks and MCP server integrations within the plugin manifest

03Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills command-name

For use in Claude.ai and ChatGPT

Download Skill