What is the required location for the plugin manifest?

The plugin.json file must be located within the .claude-plugin/ directory at the plugin root to be recognized by Claude Code.

How do I add multiple paths for agents in my plugin?

You can specify an array of relative paths in the 'agents' field of your plugin.json manifest to supplement the default directory discovery.

Does Claude Code automatically find my custom commands?

Yes, any Markdown files located in the commands/ directory are automatically discovered and registered as slash commands during the plugin loading process.

Why should I use ${CLAUDE_PLUGIN_ROOT} in my plugin?

It ensures your plugin remains portable across different operating systems and installation methods by resolving paths dynamically relative to where the plugin is installed.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

0•

Developer Tools

Guides developers in scaffolding, organizing, and configuring professional-grade Claude Code plugins using standardized architectural patterns.

This skill provides comprehensive guidance on the Claude Code plugin ecosystem, helping developers build maintainable and portable extensions. It covers everything from manifest configuration in .claude-plugin/plugin.json to the implementation of commands, agents, skills, and hooks. By enforcing directory conventions and teaching the use of portable path references like ${CLAUDE_PLUGIN_ROOT}, it ensures that plugins integrate seamlessly and operate reliably across different user environments and operating systems.

Key Features

01Standardized manifest configuration for .claude-plugin/plugin.json

02Auto-discovery mechanism optimization for seamless integration

03Implementation of portable paths via ${CLAUDE_PLUGIN_ROOT}

04Component-based organization for commands, agents, and hooks

05Automated plugin scaffolding and directory layout guidance

060 GitHub stars

Use Cases

01Scaffolding a new Claude Code plugin from scratch

02Organizing complex custom commands and sub-agents into a modular structure

03Migrating hardcoded paths to portable environment-aware references

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